Markdown 语法大全：从入门到精通的完整指南

_码力全开_

已于 2025-09-13 19:57:11 修改

阅读量1.4k

点赞数 48

CC 4.0 BY-SA版权

分类专栏： markdown 文章标签：个人开发

于 2025-09-07 17:06:46 首次发布

本文链接：https://blog.csdn.net/2401_84134448/article/details/151291210

markdown 专栏收录该内容

3 篇文章

订阅专栏

一、基础文本格式（入门级：1 分钟上手）

1、标题（层级划分）

通过 “#” 符号控制标题层级，“#” 数量越多，标题级别越低（共 6 级），符号与文字之间需加 1 个空格。

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

效果：

这是一级标题

这是二级标题

这是三级标题

这是四级标题

这是五级标题

这是六级标题

注意：六级标题为最低层级，再多 “#” 也不会生效；建议一篇文章内标题层级不超过 4 级，避免结构混乱。

2、字体样式（加粗、斜体、删除线）

通过简单符号实现文本的强调或标记，支持组合使用（如 “加粗 + 斜体”）。

*斜体*
_斜体_
**粗体**
___粗斜体___
***粗斜体***
~~删除线~~

效果：
斜体
斜体
粗体
粗斜体
粗斜体
~~删除线~~

3、引用文本（段落强调）

用于引用他人观点、名言或需要突出的文本，用 “>” 开头，支持多层嵌套。

> 这是引用文本
> > 这是第二层引用
> > > 这是第三层引用

效果：

这是引用文本

这是第二层引用

这是第三层引用

二、内容结构排版（基础级：优化阅读逻辑）

当文本篇幅较长时，需要通过列表、分割线等语法梳理结构，提升可读性，这部分语法需注意符号与内容的间距。

1、无序列表（非编号内容）

无序列表使用 “*”、“+” 或 “-” 开头，与内容之间需加 1 个空格。

* 列表 1
+ 列表 2
- 列表 3

效果：

列表 1

列表 2

列表 3

嵌套列表：在子列表前加 4 个空格（或 1 个 Tab）。

* 列表 1
    * 子列表 1
    + 子列表 2
    - 子列表 3

效果：

列表 1
- 子列表 1
- 子列表 2
- 子列表 3

2、有序列表（编号内容）

有序列表：使用数字加 “.” 开头，与内容之间需加 1 个空格。

1. 列表 1
2. 列表 2
3. 列表 3

效果：
4. 列表 1
5. 列表 2
6. 列表 3

嵌套列表：子列表前加 4 个空格（或 1 个 Tab）。

8. 列表 1
    1. 子列表 1
    2. 子列表 2
    3. 子列表 3

效果：

列表 1
1. 子列表 1
2. 子列表 2
3. 子列表 3

3、分割线（内容分区）

用于分隔不同段落或章节，让页面结构更清晰，支持三种语法，效果一致。
分割线用于将文本内容分隔成不同区域，用 “—” 或 “***” 或 “___” 表示。

---
***
___

效果：

注意：分割线前后建议空 1 行，避免与上下文本粘连；不要在 “—” 前加文本（否则会被识别为二级标题）。

4、代码块（展示代码 / 命令）

用于展示代码片段、命令行指令或需要保留格式的文本，分为 “行内代码” 和 “多行代码块”。

1、行内代码

用反引号（`）包裹的文本，用于展示代码或命令，不会改变其原始格式。

`print("Hello, World!")`

效果：
print("Hello, World!")

2、多行代码块

用 3 个反引号（```）包裹的文本，用于展示多行代码或命令，会保留原始格式，支持语法高亮。

```python
print("Hello, World!")
```

效果：

print("Hello, World!")

三、进阶内容元素（进阶级：丰富内容形式）

当基础排版满足需求后，可通过链接、图片、表格等语法添加更多元素，让内容更生动，这部分需注意语法格式的完整性。

1. 链接（跳转外部 / 内部内容）

分为 “普通链接”“锚点链接”（跳转文章内指定位置）和 “自动链接”（直接显示 URL）。

普通链接：

[链接显示文本](https://www.baidu.com "鼠标悬停提示文本")

效果：
链接显示文本

注意：“提示文本” 可选，不写则鼠标悬停时无提示；链接地址需完整（如 “https://” 开头）。

锚点链接：用于跳转文章内指定标题

[跳转到一级标题](#三进阶内容元素进阶级丰富内容形式)（“#” 后为标题文本，需与目标标题完全一致，不区分大小写）

效果：
跳转到一级标题

注意：目标标题中的特殊符号 “、”“（”“）”“：” 要去除，标题中的空格要替换为 “-”。

自动链接：用 “<>” 包裹 URL 或邮箱

<https://www.baidu.com>

效果：
https://www.baidu.com（直接显示链接，点击可跳转）。

2. 图片（插入图片资源）

语法与链接类似，仅多一个 “!”。

![图片加载失败时的提示文本](https://img-blog.csdnimg.cn/img_convert/057d70b7de204382e5524dfbbb2fda18.png "鼠标悬停提示文本")

效果：
图片加载失败时的提示文本

3. 表格（结构化数据展示）

用于展示结构化数据（如 “对比表”“参数表”），语法需注意 “分隔线” 和 “对齐方式” 的设置。

| 表头1 | 表头2 | 表头3 |
| --- | :---: | ---: |  # 分隔线，控制对齐方式
| 内容1 | 内容2 | 内容3 |
| 内容4 | 内容5 | 内容6 |

分隔线：“—” 数量不影响，仅需保证有即可；
对齐方式：—左加 “:” 为左对齐（默认），中间加 “:” 为居中对齐，右加 “:” 为右对齐；

效果：

表头1	表头2	表头3
内容1	内容2	内容3
内容4	内容5	内容6

四、高级扩展功能（高级：满足特殊需求）

这部分语法并非所有 Markdown 编辑器都支持（需看工具兼容性，如 Typora、Obsidian、语雀等），适合有特殊排版需求的场景。

1. 任务列表（待办事项）

用于创建 “待办 / 已办” 清单，用 “- [ ]” 表示待办，“- [x]” 表示已办（“[ ]” 内的空格和 “x” 需严格对应）。

- [x] 已完成任务1
- [ ] 待完成任务2
- [ ] 待完成任务3

效果：

已完成任务1
待完成任务2
待完成任务3

2. 脚注（补充说明）

用于在文章末尾添加注释，避免正文被无关内容打断，语法分为 “脚注标记” 和 “脚注内容”。

正文内容需要注释的部分[^1]
更多内容[^2]

[^1]: 这是第一个脚注的具体内容（支持换行、引用等格式）
[^2]: 这是第二个脚注的具体内容

效果：
正文内容需要注释的部分¹
更多内容²

3. 数学公式（学术 / 技术场景）

用于插入数学公式（如微积分、线性代数公式），需编辑器支持 LaTeX 语法（如 Typora、语雀），分为 “行内公式” 和 “块级公式”。

行内公式：用2个“$”包裹LaTeX语法。

这是行内公式$E=mc^2$

效果：
这是行内公式 $E=mc^2$
块级公式：用 2 个 “$$” 包裹 LaTeX 语法。

$$
\int_{0}^{1} x^2 dx = \frac{1}{3}
$$

效果：
$\int_{0}^{1} x^2 dx = \frac{1}{3}$

技术靠练不靠看，如果你有好用的 Markdown 技巧，或是遇到了渲染问题，欢迎在评论区分享。期待看到你用 Markdown 写的优质文章。

这是第一个脚注的具体内容（支持换行、引用等格式） ↩︎
这是第二个脚注的具体内容 ↩︎