Markdown 语法备忘

几乎所有 Markdown 应用程序都支持 John Gruber 原始设计文档中概述的基本语法。但不同 Markdown 处理器之间会存在细微的差异。

标题

1
2
3
4
5
6


# 一级标题（页面主标题，建议1篇文章仅1个）
## 二级标题（章节标题）
### 三级标题（子章节标题）
#### 四级标题
##### 五级标题
###### 六级标题（最低级标题，避免过度使用）

段落与换行

段落：直接输入文本，段落间用 1 个或多个空行分隔（若仅换行不空格，会被视为同一段落的换行）。
强制换行：在需要换行的位置加 2个及以上空格 + 回车（部分平台支持 \ 结尾换行）。

1
2
3
4
5


这是第一段文本，直接输入即可。
这里需要强制换行（结尾加2个空格）  
这是换行后的内容。

这是第二段文本（与上段间隔1个空行）。

文本格式

语法类型	Markdown 语法	适用场景	效果展示
粗体	`粗体文本` 或 `__粗体文本__`	强调重点内容	粗体文本
斜体	`斜体文本` 或 `_斜体文本_`	强调语气、专有名词	斜体文本
粗斜体	`*粗斜体文本*` 或 `___粗斜体文本___`	极强强调	粗斜体文本
删除线	`~~删除线文本~~`	标记废弃内容、修改痕迹	~~删除线文本~~
行内代码	`单行代码或变量`	标记代码片段、命令、变量	`print("Hello Markdown")`
行内链接	`[链接文本](链接地址 "可选标题")`	插入外部链接、内部锚点	Markdown 官网
行内图片	`![图片alt文本](图片地址 "可选标题")`	插入图片（alt 文本用于加载失败时显示）
注释	`<!-- 这是不会显示的注释 -->`	记录编辑思路、隐藏说明	（无显示效果）

列表

无序列表

使用 *、+、- 开头 (三者效果一致)，符号后加空格，嵌套时缩进2 个空格或1 个 TAB。

1
2
3
4
5


- 无序列表项1（用-开头）
  - 嵌套无序列表项1.1
  - 嵌套无序列表项1.2
* 无序列表项2（用*开头）
+ 无序列表项3（用+开头）

效果如下：

无序列表项1（用-开头）
- 嵌套无序列表项1.1
- 嵌套无序列表项1.2

无序列表项2（用*开头）

无序列表项3（用+开头）

有序列表

使用 数字 + . 开头（数字无需连续，平台会自动修正），符号后加空格，支持嵌套无需列表。

1
2
3
4
5


1. 有序列表项1
2. 有序列表项2
    - 嵌套无序列表项2.1
    - 嵌套无序列表项2.2
5. 有序列表项3（数字不连续，显示仍为3）

效果如下：

有序列表项1
有序列表项2
- 嵌套无序列表项2.1
- 嵌套无序列表项2.2
有序列表项3（数字不连续，显示仍为3）

引用

使用 > 开头，符号后加空格，支持嵌套（多一层 >）和混合其他格式（如列表、粗体等）。

1
2
3
4
5
6
7


> 这是一级引用文本（用于引用他人观点、名言）。
> 
>> 这是嵌套引用文本（二级引用）。
> 
> 引用中可混合格式：
> - 无序列表
> - **粗体文本**

分割线

使用 ---、***、___ 表示（三者效果一致），需单独占一行，前后建议空行，避免与二级标题混淆。

1
2
3
4
5
6
7
8
9


文本内容1

--- （分割线）

文本内容2

*** （分割线）

文本内容3

代码块

用于展示多行代码，支持语法高亮（指定编程语言后，平台会自动着色）。语法如下：

1
2
3
4
5


```语言名称
# 代码内容
代码行1
代码行2
```

表格

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


| 姓名   | 年龄 | 职业       |
|--------|------|------------|
| 张三   | 25   | 程序员     |
| 李四   | 30   | 产品经理   |
| 王五   | 28   | 设计师     |

# 带对齐的表格
| 左对齐列 | 居中对齐列 | 右对齐列 |
| :------- | :--------: | -------: |
| 内容1    |   内容2    |    内容3 |
| 长文本内容 | 居中文本  |    100   |

示例如下：

姓名	年龄	职业
张三	25	程序员
李四	30	产品经理
王五	28	设计师

带对齐的表格:

左对齐列	居中对齐列	右对齐列
内容1	内容2	内容3
长文本内容	居中文本	100

扩展语法

任务列表

用于标记待办事项，用 -[ ] 表示未完成，-[x] 表示已完成（[ ] 中需加空格）

1
2
3
4


- [x] 完成 Markdown 基础语法学习
- [x] 编写示例代码
- [ ] 整理文档结构
- [ ] 发布文章

效果如下：

完成 Markdown 基础语法学习
编写示例代码
整理文档结构
发布文章

锚点链接

用于跳转到文章内的指定标题（需注意标题的 “锚点格式”：空格替换为 -，大写转小写，特殊字符移除）

1
2
3
4
5
6
7


# 目录
- [1. 基础文本格式](#一基础文本格式)
- [2. 结构类元素](#二结构类元素)

# （下方为标题，作为锚点目标）
## 一、基础文本格式
## 二、结构类元素

说明：

锚点目标为标题时，需将标题的 “编号、标点、空格” 转换为平台支持的格式（如 GitHub 会自动将 ## 一、基础文本格式 转换为 #一基础文本格式）。
部分平台（如 Hugo）支持自定义锚点：## 标题 {#custom-anchor}，跳转时用 [链接]({#custom-anchor})。

脚注

用于添加补充说明，不影响正文阅读，鼠标 hover 或点击可查看详情（兼容性：Github 支持，部分轻量编辑器不支持）

1
2
3
4
5
6


这是需要补充说明的文本[^1]。
这是另一处需要脚注的内容[^2]。

# 脚注内容（通常放在文章末尾）
[^1]: 这里是第一个脚注的详细说明。
[^2]: 这里是第二个脚注的详细说明，支持换行和**粗体**格式。

定义列表

用于 “术语 - 解释” 场景，术语前无符号，解释行用 : 开头（兼容性：GitHub 支持，部分平台不支持）。

1
2
3
4
5


Markdown
: 一种轻量级标记语言，由 John Gruber 创造。

HTML
: 超文本标记语言，用于构建网页结构。

效果如下：

Markdown: 一种轻量级标记语言，由 John Gruber 创造。
HTML: 超文本标记语言，用于构建网页结构。

数学公式

相关数学公式可参考 Markdown 数学公式

通过 LaTex 语法插入数学公式，需用 $ 包裹（行内公式）或 $$ 包裹 (块级公式)，需平台支持（如 Hugo 需安装数学公式插件，Notion、Typora 原生支持）

1
2
3
4
5
6
7
8


# 行内公式
圆的面积公式：$S = \pi r^2$ (r 为半径)

# 块级公式 (单独占行，居中显示)

$$
\sum_{i=1}^n i = \frac{n(n+1)}{2}
$$

效果如下：

行内公式：

圆的面积公式：$S = \pi r^2$ (r 为半径)
块级公式：
$$ \sum_{i=1}^n i = \frac{n(n+1)}{2} $$