第 5 章：引用与分隔线
引用让重要内容脱颖而出，分隔线让章节结构清晰可见。两个简单语法，让你的文档更有层次。
学习目标
- 掌握引用块的基本语法与嵌套写法
- 学会在引用块内嵌入多种元素
- 了解分隔线的作用与语法
5.1 引用块（Blockquotes）
使用 > 符号创建引用块：
markdown
> 这是引用内容。
> 换一行也还是引用的一部分。渲染： 这是引用内容。 换一行也还是引用的一部分。
多段引用
段落之间的空行也需要加上 >：
markdown
> 这是第一段。
>
> 这是第二段。渲染： 这是第一段。
这是第二段。
引用块内的段落
空行上如果不写 >，引用就会被截断：
markdown
> 这是引用第一段。
这不是引用的内容了。渲染： 这是引用第一段。
这不是引用的内容了。
5.2 嵌套引用
用多个 > 实现嵌套引用：
markdown
> 一层引用
>> 二层引用
>>> 三层引用渲染： 一层引用
二层引用
三层引用
5.3 引用块内嵌入其他元素
引用块非常灵活，几乎可以在里面放任何内容：
引用内包含标题
markdown
> ## 这是一个二级标题
>
> 这是正文内容。引用内包含列表
markdown
> 本周计划：
>
> - 完成前端重构
> - 编写单元测试
> - 更新 API 文档渲染： 本周计划：
- 完成前端重构
- 编写单元测试
- 更新 API 文档
引用内包含代码块
markdown
> 配置示例：
>
> ```yaml
> server:
> port: 8080
> host: localhost
> ```引用内包含图片和链接
markdown
> 更多信息请参考 [官方文档](https://docs.example.com)
>
> 引用内包含引用（混合嵌套）
markdown
> 外层引用包含以下提醒：
>
> > ⚠️ 特别注意：此功能在 v2.0 后已废弃
>
> 请尽快完成迁移。5.4 引用的常见用途
| 场景 | 示例 |
|---|---|
| 引用他人内容 | > 正如阮一峰老师所说：... |
| 提示/警告/注意 | > ⚠️ 该版本不再维护 |
| 知识点小结 | > 💡 小结：Markdown 的核心优势是... |
| 诗歌/名言 | > 生活不止眼前的苟且，还有诗和远方 |
| 邮件回复样式 | > 原始邮件内容 |
💡 结合 Emoji 可以让引用块语义更明确：
> ⚠️ 警告、> 💡 技巧、> 📝 注意、> ✅ 完成。
5.5 分隔线（Horizontal Rules）
使用三个或以上的 ---、*** 或 ___ 创建分隔线：
markdown
段落一
---
段落二三种写法
markdown
--- ← 推荐：最常用，清晰直观
***
___三种写法渲染效果完全相同：
⚠️ 注意：
---如果紧跟在文字后面（没有空行），部分解析器会把它误判为二级标题的底行式写法（Setext heading）。安全起见，分隔线前后各留一个空行。
分隔线与标题的歧义
markdown
这是分隔线
---
这不是分隔线，是标题
---第二行的 --- 紧跟在文字后面，会被解析为 h2 标题，而不是分隔线。加上空行就安全了：
markdown
这是分隔线
---
这是标题
---5.6 语法速查
| 语法 | 写法 | 说明 |
|---|---|---|
| 引用块 | > 内容 | 每行可加 > |
| 嵌套引用 | >> 内容 | 多个 > 嵌套 |
| 引用内空段 | > （空行也加 >） | 不加 > 引用会中断 |
| 分隔线 | ---（前后空行） | 推荐用三个短横 |
本章小结
| 要点 | 说明 |
|---|---|
| 引用语法 | > 开头，可嵌套多层 |
| 引用内嵌元素 | 标题、列表、代码、图片等都可以放 |
| 分隔线 | --- 最常用，前后必须空行 |
| 配合使用 | 引用 + Emoji = 语义化提示块；分隔线 = 章节分隔 |
下一章预告
技术文档的灵魂是代码示例。下一章学习如何优雅地嵌入代码——从行内代码到语法高亮代码块。
👉 第 6 章：代码