Markdown 是一种轻量级标记语言，它允许人们使用易读易写的纯文本格式编写文档。本教程将介绍 Markdown 的基本语法。
1. 标题#
Markdown 支持两种标题的语法，类 Setext 和类 atx 形式。
ATX 风格标题#
1
2
3
4
5
6
| # 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
|
Setext 风格标题#
1
2
3
4
5
| 一级标题
========
二级标题
--------
|
2. 段落和换行#
段落是由一个或多个连续的文本行组成，它的前后要有一个以上的空行。
要在段落内强制换行，可以在行尾插入两个或以上的空格，然后回车。
3. 文本样式#
1
2
3
| *斜体文本* 或 _斜体文本_
**粗体文本** 或 __粗体文本__
***粗斜体文本*** 或 ___粗斜体文本___
|
效果：
删除线#
效果：删除的文本
4. 列表#
无序列表#
1
2
3
4
5
6
7
8
9
10
11
12
13
| - 项目1
- 项目2
- 子项目1
- 子项目2
- 项目3
或者使用 * 或 +：
* 项目1
* 项目2
+ 项目1
+ 项目2
|
有序列表#
1
2
3
4
5
| 1. 第一项
2. 第二项
1. 子项目1
2. 子项目2
3. 第三项
|
任务列表#
1
2
3
| - [x] 已完成的任务
- [ ] 未完成的任务
- [ ] 另一个未完成的任务
|
效果：
5. 链接#
行内式链接#
1
2
| [链接文本](URL)
[链接文本](URL "可选标题")
|
示例：
1
2
| [Google](https://www.google.com)
[Google](https://www.google.com "Google 搜索")
|
参考式链接#
1
2
3
| [链接文本][标识符]
[标识符]: URL "可选标题"
|
示例：
1
2
3
4
5
| [Google][1]
[GitHub][2]
[1]: https://www.google.com "Google"
[2]: https://github.com "GitHub"
|
自动链接#
1
2
| <https://www.example.com>
<email@example.com>
|
6. 图片#
行内式图片#
1
2
| 
|
参考式图片#
1
2
3
| ![替代文本][标识符]
[标识符]: 图片URL "可选标题"
|
7. 代码#
行内代码#
代码块#
使用三个反引号包围代码块：
指定语言的代码块#
1
2
3
4
| ```python
def hello_world():
print("Hello, World!")
```
|
1
2
3
4
5
| ```javascript
function helloWorld() {
console.log("Hello, World!");
}
```
|
8. 引用#
1
2
3
4
5
6
| > 这是一个引用
>
> 引用可以有多个段落
> 引用也可以嵌套
>> 这是嵌套的引用
|
效果：
这是一个引用
引用可以有多个段落
引用也可以嵌套
这是嵌套的引用
9. 表格#
1
2
3
4
| | 列1 | 列2 | 列3 |
|-----|-----|-----|
| 内容1 | 内容2 | 内容3 |
| 内容4 | 内容5 | 内容6 |
|
对齐方式#
1
2
3
4
| | 左对齐 | 居中对齐 | 右对齐 |
|:-------|:--------:|-------:|
| 内容1 | 内容2 | 内容3 |
| 内容4 | 内容5 | 内容6 |
|
效果：
| 左对齐 | 居中对齐 | 右对齐 |
|---|
| 内容1 | 内容2 | 内容3 |
| 内容4 | 内容5 | 内容6 |
10. 分割线#
11. 转义字符#
使用反斜杠 \ 来转义特殊字符：
1
2
3
4
| \* 不会变成列表项
\# 不会变成标题
\` 不会变成代码
\[不会变成链接\]
|
12. HTML 标签#
Markdown 兼容 HTML，可以直接使用 HTML 标签：
1
2
3
| <div style="color: red;">红色文本</div>
<br>
<kbd>Ctrl</kbd> + <kbd>C</kbd>
|
13. 数学公式（扩展语法）#
行内公式#
块级公式#
1
2
3
| $$
\sum_{i=1}^{n} x_i = x_1 + x_2 + \cdots + x_n
$$
|
14. 脚注（扩展语法）#
1
2
3
| 这是一个脚注的例子[^1]。
[^1]: 这是脚注的内容。
|