Markdown语法总结

Markdown 是一种轻量级的标记语言，它让我们可以以易读易写的纯文本格式编写文档，然后转换为有效的 HTML。它广泛应用于撰写文档、博客、论坛帖子以及各种需要格式化文本的场合。以下是我准备的 Markdown 语法的详细总结：

1. 标题 (Headers)

使用 # 来表示不同级别的标题，共有六级标题。

 # 一级标题
 ## 二级标题
 ### 三级标题
 #### 四级标题
 ##### 五级标题
 ###### 六级标题

效果：

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

2. 段落与换行

段落由一个或多个空行分隔。行末加两个或以上空格后回车可实现换行。

 这是第一段。
 ​
 这是第二段，可以在这里加换行。  
 这是同一段的新行。

3. 强调 (Emphasis)

使用 * 或 _ 包围文本实现斜体，使用 ** 或 __ 实现粗体。

 *斜体文本*
 _斜体文本_
 ​
 **粗体文本**
 __粗体文本__
 ​
 ***粗斜体文本***
 ___粗斜体文本___

效果：

斜体文本 斜体文本

粗体文本 粗体文本

粗斜体文本 粗斜体文本

4. 列表 (Lists)

无序列表

使用 *、+ 或 - 表示。

 - 项目一
 - 项目二
   - 子项目二点一
   - 子项目二点二
 * 项目三
 + 项目四

有序列表

使用数字加点。

 1. 第一项
 2. 第二项
    1. 子项二点一
    2. 子项二点二
 3. 第三项

效果：

• 项目一

• 项目二

  • 子项目二点一

  • 子项目二点二

• 项目三

• 项目四

1. 第一项

2. 第二项

   1. 子项二点一

   2. 子项二点二

3. 第三项

5. 链接 (Links)

行内链接

 这是一个[示例链接](https://www.example.com)。

参考式链接

 这是一个[示例链接][1]。
 ​
 [1]: https://www.example.com

自动链接

 <https://www.example.com>

效果：

这是一个示例链接。

6. 图片 (Images)

语法与链接类似，但前面加 !。

行内图片

![替代文本](https://www.example.com/image.jpg)

参考式图片

![替代文本][image1]

[image1]: https://www.example.com/image.jpg

指定图片大小（扩展语法，部分渲染器支持）

![替代文本](https://www.example.com/image.jpg =250x250)

效果：

7. 代码 (Code)

行内代码

使用反引号 ` 包围。

这是一个 `行内代码` 示例。

代码块

使用缩进四个空格或使用三个反引号 ``` 包围。

缩进方式

    这是一个代码块。
    可以包含多行代码。

反引号方式

这是一个代码块。 可以包含多行代码。

语法高亮（支持的渲染器）

在三个反引号后指定语言。

```python
def hello_world():
    print("Hello, world!")

效果：

```python
def hello_world():
    print("Hello, world!")

8. 引用 (Blockquotes)

使用 > 表示引用。

> 这是一个引用。
> 可以包含多行文本。

> ### 嵌套引用
> 引用中可以包含标题。

效果：

这是一个引用。 可以包含多行文本。

嵌套引用

引用中可以包含标题。

9. 分割线 (Horizontal Rules)

使用三个或以上的 -、* 或 _。

---

* * *

___

效果：

---

---

---

10. 表格 (Tables)

使用 | 和 - 来创建表格。

| 表头1 | 表头2 | 表头3 |
| ------ | ------ | ------ |
| 单元格1 | 单元格2 | 单元格3 |
| 单元格4 | 单元格5 | 单元格6 |

对齐方式

通过在分隔符中添加 : 来设置对齐方式。

• 左对齐：:---

• 右对齐：---:

• 居中对齐：:---:

| 左对齐 | 右对齐 | 居中对齐 |
| :------ | ------: | :------: |
| 单元格1 | 单元格2 | 单元格3 |
| 单元格4 | 单元格5 | 单元格6 |

效果：

左对齐	右对齐	居中对齐
单元格1	单元格2	单元格3
单元格4	单元格5	单元格6

11. 内联 HTML

Markdown 允许直接嵌入 HTML 代码，用于实现 Markdown 不支持的格式。

这是一个使用 <span style="color:red">红色文本</span> 的示例。

效果：

这是一个使用 红色文本 的示例。

12. 转义字符

使用反斜杠 \ 转义 Markdown 特殊字符，使其作为普通字符显示。

\* 反斜杠加星号显示为星号 *
\# 显示为 #

效果：

* 反斜杠加星号显示为星号 * # 显示为 #

13. 注脚 (Footnotes)

部分渲染器支持注脚语法。

这是一个带注脚的句子。[^1]

[^1]: 这是注脚内容。

效果：

这是一个带注脚的句子。1

[1]  这是注脚内容。

14. 任务列表 (Task Lists)

部分渲染器支持任务列表。

- [x] 完成任务一
- [ ] 未完成任务二
- [ ] 未完成任务三

效果：

• 完成任务一
• 未完成任务二
• 未完成任务三

15. 表情符号 (Emojis)

部分渲染器支持使用 : 包围的表情符号代码。

这是一个笑脸 :smile:。

效果：

这是一个笑脸 😊。

16. 脚注 (Footnotes)

部分 Markdown 渲染器支持脚注。

这是一个带脚注的例子。[^1]

[^1]: 这是脚注内容。

效果：

这是一个带脚注的例子。1

[1]  这是脚注内容。

17. 自动编号列表 (Automatic Numbered Lists)

Markdown 会自动为有序列表编号，无需手动调整。

1. 第一项
1. 第二项
1. 第三项

效果：

1. 第一项

2. 第二项

3. 第三项

18. 嵌套列表 (Nested Lists)

无序列表和有序列表可以相互嵌套。

1. 第一项
   - 子项一
   - 子项二
2. 第二项
   1. 子项二点一
   2. 子项二点二

效果：

1. 第一项

   • 子项一

   • 子项二

2. 第二项

   1. 子项二点一

   2. 子项二点二

19. 代码高亮 (Code Highlighting)

在代码块指定语言后，可以实现语法高亮。支持的语言取决于渲染器。

```javascript
function greet() {
    console.log("Hello, world!");
}

效果：

```javascript
function greet() {
    console.log("Hello, world!");
}

20. 组合使用

Markdown 支持多种语法组合使用，以实现复杂的格式效果。

## 标题与列表结合

- **粗体项**
  - *斜体子项*
  - `代码子项`

1. 有序列表项
   1. **嵌套粗体**
   2. _嵌套斜体_

效果：

标题与列表结合

• 粗体项

  • 斜体子项

  • 代码子项

1. 有序列表项

   1. 嵌套粗体

   2. 嵌套斜体

21. 其他扩展语法

一些 Markdown 渲染器支持额外的扩展语法，如：

• 表格扩展：支持复杂表格布局。

• 数学公式：使用 LaTeX 语法书写数学公式，如 $E=mc^2$。

• 脚注：更复杂的脚注管理。

• 自定义容器：如信息框、警告框等。

示例：数学公式

爱因斯坦的质能方程：$E=mc^2$

效果：

爱因斯坦的质能方程：(E=mc^2)