Typora 的 Markdown 语法

Markdown 旨在尽可能易读易写。

然而，可读性是最重要的。一个Markdown格式的 文档应当以原样发布，作为纯文本，无需查看 就像被标记或格式说明一样。而 Markdown 的语法受到了多种现有文本转 HTML 语言的影响 筛选器——包括Setext、atx、Textile、reStructuredText、Grutatext和EtText——这是最大的单一来源 Markdown 语法的灵感来自纯文本邮件的形式。

文章作为一个笔记的形式只记录了我可能会用到的部分。

标题

标题在行的开头使用1-6个＃字符，对应于标题级别1-6。例如：

如果输入”### 标题一“则会如下所示：

标题一

如果需要次一级的标题则再加一个#

注意：==#符号后有一个空格==，否则会无效。

列表

输入 * list item 1 将创建一个无序列表，该 * 符号可以替换为 + 或 -.

输入 1. list item 1 将创建一个有序列表。

例如：

输入”* 序号一“，则会显示：

• 序号一
• 可自定义的文字

输入“1. 序号一”，则会显示：

1. 序号一
2. 可自定义的文字

输入“+ 序号一”，则也会显示：

• 序号一
• 可自定义的文字

任务列表

任务列表是标记为[ ]或[x]（未完成或完成）的项目的列表。

只需在文字前加入“- [ ] “或”- [x] “

例如：

• 任务一

• 任务二

• 任务三

• 任务四

（栅栏式）代码块

输入```之后输入一个可选的语言标识符，然后按return键后输入代码，我们将通过语法高亮显示它：

例如：

输入：
```
选择编写语言，
然后输入内容，就得到了这个板块。
当然，那个符号是三个英文状态下的`

表格

输入 | First Header | Second Header | 并按下 return 键将创建一个包含两列的表。

例如：

First Header	Second Header

创建表后，焦点在该表上将弹出一个表格工具栏，您可以在其中调整表格，对齐或删除表格。您还可以使用上下文菜单来复制和添加/删除列/行。

==记得输入完后回车==

脚注

您可以像这样创建脚注：

输入：
文中需要提供[^自定义的文字]
则会如下所示，当然在文末记得对脚注进行加以解释

文中需要提供^自定义的文字

在文末或可能存在的地方单独一行输入：
[^自定义的文字]:  对该文字的描述
效果如下所示：

水平线

输入 *** 或 — 在空行上按 return 键将绘制一条水平线。

例如：

---

---

目录 (TOC)

输入 [toc] 然后按 Return 键将创建一个“目录”部分，自动从文档内容中提取所有标题，其内容会自动更新。

图表 (Sequence, Flowchart and Mermaid)

Typora 支持, sequence, flowchart and mermaid, 使用前要先从偏好设置面板启用该功能。

详细信息请参阅此 文档

对于这个内容还没有使用过。

链接

Markdown 支持两种类型的链接：内联和引用。

输入"[被显示的文字](链接或地址)" 则会显示为：

被显示的文字

该文字单击即可打开链接

---

输入"[被显示的文字][可空白或自定义]" 则会显示为：

[被显示的文字][链接或地址]

该文字按住ctrl再单击即可打开链接

记得在文末补充下列文字

---

如果需要跳转至文章某个位置，实例如下所示：

[此链接](https://support.typoraio.cn/zh/Markdown-Reference/#块元素) 

此链接

---

URL网址
Typora允许您将 URL 作为链接插入，用 <括号括起来>。

输入<i@typora.io>则显示：

i@typora.io

Typora也将自动链接标准URL。

图片

图像与链接类似， 但在链接语法之前需要添加额外的 ! 字符。 图像语法如下所示：

输入![替代文字](/path/to/img.jpg)则显示：

输入![替代文字](/path/to/img.jpg "可选标题")则显示：

您可以使用拖放操作从图像文件或浏览器来插入图像。并通过单击图像修改 markdown 源代码。如果图像在拖放时与当前编辑文档位于同一目录或子目录中，则将使用相对路径。

强调（斜体）

Markdown 将星号 (*) 和下划线(_) 视为强调的指示。用一个 * or _ 包裹文本，例如：

*单个星号*

_单个下划线_

显示

单个星号

单个下划线

---

要在用作强调分隔符的位置生成文字星号或下划线，可以用反斜杠转义：

\*这个文字被文字星号包围\*

粗体

用两个 * 或 _ 包裹的文本将使用HTML 标签包裹，例如：

**双星号**
__双重下划线__

显示：

双星号

双重下划线

代码

要指示代码范围，请使用反引号（`）进行包裹。与预格式化的代码块不同，代码跨度表示正常段落中的代码。例如：

输入`printf()`

则会显示：

printf()

删除线

GFM通过添加语法来创建删除线文本，标准的Markdown中缺少该文本。

输入：
~~错误的文字。~~

则显示为：

错误的文字。

下划线

下划线由原始HTML提供支持。

输入:
<u>下划线</u> 

显示为：

下划线

表情符号 :smile:

输入表情符号的语法是 :smile:

用户可以通过 ESC 按键触发表情符号的自动完成建议，或者在偏好设置面板里启用后自动触发表情符号。此外，还支持直接从 Edit -> Emoji & Symbols 菜单栏输入UTF8表情符号字符。

:smile_cat:

下标

要使用此功能，首先，请在 偏好设置 面板 -> Markdown扩展语法 选项卡中启用它。然后用 ~ 来包裹下标内容。

例如： H~2~O, X~long\ text~/

显示 :H2O, Xlong\ text/

上标

要使用此功能，首先，请在 偏好设置 面板 -> Markdown扩展语法 选项卡中启用它。然后用 ^ 来包裹上标内容。

例如： X^2^。

显示： X^2^。

高亮

要使用此功能，首先，请在 偏好设置 面板 -> Markdown扩展语法 选项卡中启用它。然后用 == 来包裹高亮内容。

例如： ==highlight==

显示: ==highlight==

---

---

内容来自于typora的官方文档

少了关于公式部分的描述

Markdown支持加入HTML语言让文章更具特色