掌握这些语法，你就能写90%的文档了。
一、准备工作
在开始之前，你需要一个地方练习：
| 方式 | 地址 | 推荐度 |
|---|---|---|
| 在线练习 | StackEdit.io | ⭐⭐⭐⭐⭐ |
| 在线练习 | Dillinger.io | ⭐⭐⭐⭐ |
| 本地编辑 | VS Code + Markdown Preview Enhanced | ⭐⭐⭐⭐⭐ |
打开在线编辑器，边看边练，效果最好。
二、标题
2.1 语法
用 # 号表示标题，# 的数量表示级别：
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
渲染效果：
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
2.2 注意事项
| 规则 | 说明 |
|---|---|
# 后要加空格 | # 标题 ✅ #标题 ❌ |
| 最多6级 | 超过6个#无效 |
| 建议只用1-4级 | 太深的层级不利于阅读 |
2.3 最佳实践
# 文档标题（唯一）
## 第一章
### 1.1 小节
#### 1.1.1 细节
## 第二章
一个文档只有一个一级标题。
三、段落与换行
3.1 段落
规则：空一行表示新段落。
这是第一段。
这是第二段。
渲染效果：
这是第一段。
这是第二段。
3.2 换行
规则：行末加两个空格，或使用 <br>。
第一行
第二行（这行没换行，会连在一起）
第一行
第二行（行末有两个空格，会换行）
注意：不同渲染器行为可能不同。推荐使用空行分段。
3.3 常见错误
| 错误写法 | 结果 |
|---|---|
| 两行没空行 | 显示在同一行 |
| 多个空行 | 仍然只算一个分段 |
四、强调
4.1 加粗
**这是加粗的文字**
__这也是加粗的文字__
渲染效果： 这是加粗的文字
4.2 斜体
*这是斜体的文字*
_这也是斜体的文字_
渲染效果： 这是斜体的文字
4.3 加粗+斜体
***加粗且斜体***
**_加粗且斜体_**
渲染效果： 加粗且斜体
4.4 删除线
~~这是删除线~~
渲染效果： 这是删除线
4.5 注意事项
| 规则 | 说明 |
|---|---|
| 符号要成对 | **加粗** ✅ *加粗* ❌ |
| 不要有空格 | ** 加粗 ** ❌ |
推荐用 * | 更常见，易输入 |
五、列表
5.1 无序列表
用 -、* 或 + 表示：
- 项目一
- 项目二
- 项目三
渲染效果：
- 项目一
- 项目二
- 项目三
三种符号效果相同，推荐统一用 -。
5.2 有序列表
用数字加点表示：
1. 第一步
2. 第二步
3. 第三步
渲染效果：
- 第一步
- 第二步
- 第三步
注意：数字不重要，渲染时会自动排序。
1. 第一步
1. 第二步
1. 第三步
效果相同：
- 第一步
- 第二步
- 第三步
5.3 嵌套列表
用缩进（2或4个空格）表示层级：
- 一级列表
- 二级列表
- 三级列表
- 回到一级
渲染效果：
- 一级列表
- 二级列表
- 三级列表
- 二级列表
- 回到一级
5.4 混合嵌套
无序和有序可以混合：
1. 第一步
- 选项A
- 选项B
2. 第二步
渲染效果：
- 第一步
- 选项A
- 选项B
- 第二步
六、分隔线
用三个或更多的 -、* 或 _：
---
***
___
渲染效果：
注意：分隔线上下建议空一行。
七、引用
用 > 表示引用：
> 这是一段引用文字。
> 可以跨多行。
渲染效果：
这是一段引用文字。 可以跨多行。
7.1 嵌套引用
> 一级引用
>> 二级引用
>>> 三级引用
渲染效果：
一级引用
二级引用
三级引用
7.2 引用中包含其他元素
> ### 引用中的标题
>
> - 引用中的列表
> - 第二项
>
> **引用中的强调**
八、转义字符
当需要显示特殊字符本身时，用 \ 转义：
\# 这不是标题
\* 这不是斜体 \*
\** 这不是加粗 **
渲染效果：
# 这不是标题 * 这不是斜体 * ** 这不是加粗 **
常用转义字符：
| 字符 | 转义写法 |
|---|---|
# | \# |
* | \* |
- | \- |
> | \> |
\ | \\ |
九、完整示例
# 我的学习笔记
## 今日学习内容
今天学习了Markdown基础语法，主要包括：
### 重点内容
1. **标题**：用 `#` 表示，最多6级
2. **强调**：`*斜体*`，`**加粗**`
3. **列表**：无序用 `-`，有序用 `1.`
### 学习心得
> Markdown真的很简单，几分钟就能上手。
### 下一步计划
- 学习链接和图片
- 学习表格和代码块
- 开始写第一篇文档
---
*写于 2026年3月24日*
十、语法速查表
| 语法 | 写法 | 效果 |
|---|---|---|
| 一级标题 | # 标题 | 最大号标题 |
| 二级标题 | ## 标题 | 次大号标题 |
| 加粗 | **文字** | 文字 |
| 斜体 | *文字* | 文字 |
| 删除线 | ~~文字~~ | |
| 无序列表 | - 项目 | • 项目 |
| 有序列表 | 1. 项目 | 1. 项目 |
| 引用 | > 文字 | 引用块 |
| 分隔线 | --- | 水平线 |
十一、练习题
试着写一份自我介绍，包含：
- 标题（你的名字）
- 加粗你的技能
- 列表列出你的爱好
- 引用一句你喜欢的话
十二、总结
| 要点 | 内容 |
|---|---|
| 标题 | # 数量表示级别，后加空格 |
| 段落 | 空一行分段 |
| 强调 | **加粗** *斜体* ~~删除线~~ |
| 列表 | - 无序，1. 有序，缩进嵌套 |
| 引用 | > 开头 |
| 转义 | \ 加特殊字符 |
