Markdown 语法 (供快速查阅)

Markdown 基本语法

标题语法

• 在前面添加 # ，# 的数量代表了标题的级别

• 在文本下方添加任意数量的 =为一级标题，- 为二级标题

段落语法

• 用空白行将一行或多行文本分割

换行语法

• 在行的末尾加上HTML的标签：<br>

• 在行的末尾添加两个或多个空格之后回车

强调语法

• 粗体: 在要强调的内容前后各添加两个星号 **

• 斜体: 在要强调的内容前后各添加一个星号 *

• 粗体和斜体: 强调的内容前后各添加三个星号 ***

引用语法

• 块引用: 在段落的每行前加一个 >

• 嵌套块引用: 在要嵌套的段落前加一个 >>

• 带有其它元素的块引用: 在语句前加上>其他元素 比如 >###

列表语法

• 有序列表: 在每个列表项前添加数字并紧跟一个英文句点

• 无序列表: 在每个列表项前加 -, *, 或者 +，用制表符缩进一个或多个列表项创建嵌套列表

• 在列表中嵌套其它元素: 将该元素缩进四个空格或一个制表符

代码语法

• 将单词或短语表示为代码: 将其包裹在反引号 `中

• 转义反引号: 表示为代码的句子中包含有反引号, 则将内容包含在两个反引号中

• 围栏代码块: 在代码块之前和之后的行上使用三个反引号```或三个波浪号~~~(反引号顶行写)

分割线语法

• 在单独一行上使用三个或多个 *, 破折号或下划线, 为了兼容性在分割线的前后均添加空白行

链接语法

• 添加链接: 链接文本放在中括号, 链接地址与链接Title放在后面括号并且中间用空格隔开

• 网址和 Email 地址: 用尖括号把网址和 Email 变成可点击的链接

• 强调链接: 在链接前后增加 **

• 将链接表示为代码: 在方括号中添加反引号 `

• 引用类型链接: 分为与文本保持内联的部分和存储在文件中其他位置的部分

  • 第一部分: 用两组中括号设置, 第一组包围显示为链接的文本, 第二组显示一个标签,用于指向您存储在文档其他位置的链接
  • 第二部分: 放在括号中的标签, 其后紧跟一个冒号和至少一个空格; 链接的URL, 可以选择将其括在尖括号中(为了兼容性,用%20代替空格); 链接的可选标题, 可以将其括在双引号, 单引号或括号中

图片语法

• 插入图片: 使用 !, 然后在方括号增加替代文本, 图片链接放在圆括号里，括号里的链接后可以增加一个可选的图片标题文本

• 链接图片: 给图片增加链接, 将图像的 Markdown 括在方括号中, 然后将链接添加在圆括号中

转义字符语法

• 要显示原本用于格式化 Markdown 文档的字符，在字符前面添加反斜杠字符 \

Markdown 内嵌 HTML 标签

• 对于 Markdown 涵盖范围之外的标签, 都可以直接在文件里面用 HTML 本身, 如需使用 HTML, 不需要额外标注这是 HTML 或是 Markdown, 只需 HTML 标签添加到 Markdown 文本中即可

表格语法

• 添加表格：三个或多个连字符 --- 创建每列的标题，并使用管道 | 分隔每列
• 对齐：在标题行中的连字符的左侧，右侧或两侧添加冒号 :，将列中的文本对齐到左侧，右侧或中心

| Syntax      | Description |
| :----------- | :-----------: |
| Header      | Title       |
| Paragraph   | Text        |

脚注语法

• 创建脚注：请在方括号内添加插入符号 ^ 和数字，脚注按顺序编号
• 链接脚注：在文档指定位置 (可以将它们放在除列表，块引号和表之类的其他元素之外的任何位置) 输入相应的脚注，后面加冒号跟上文本

Here's a simple footnote,[^1]   

[^1]: This is the first footnote.  

定义列表

• 创建定义列表：第一行上键入术语。在下一行，键入一个冒号，后跟一个空格和定义

First Term  
: This is one definition of the second term.  
: This is another definition of the second term.  

删除线

• 删除线：在要删除的部分前后使用两个波浪号

~~世界是平坦的。~~ 我们现在知道世界是圆的。  

任务列表语法

• 空任务列表：在任务列表项之前添加破折号 - 和方括号 [ ]，并在其前面加上空格
• 完成任务：在方括号中填上 x

- [ ] task1  
- [x] task2  

---

以上内容参照: Markdown 语法教程