Markdown: Markdown 引用语法与嵌套
最后更新：2026-10-14
引用让你的文档更有说服力——无论是在文章中引用专家观点，还是突出重要提示，块引用都是最好的方式。
1. 你将学到
- 块引用的基本语法和写法
- 多段引用和嵌套引用
- 引用内嵌入列表、代码、标题
- 引用在排版中的最佳实践
- 引用与提示框的区别
2. 一个技术作家培训师的真实故事
(1) 痛点：引用的错误用法
Jordan 在给技术团队做文档写作培训时，发现几乎所有人都在用错误的方式做"引用"——有人用灰色字体手动加缩进，有人用斜体文字，有人甚至直接用截图贴上别人的文字。文档中引用和正文混在一起，读者分不清哪些是作者的原话、哪些是引用的外部资料。
(2) 解法：用 > 统一引用格式
Jordan 给团队定了一个规矩：所有引用的外部文字、重要提示、警告信息，一律用 > 块引用语法。团队门禁脚本会检查是否使用标准引用格式。三个月后，文档的引用一致性从 30% 提升到 98%。
3. 块引用基础
(1) 基本语法
用 > 在行首表示引用：
💡 提示： 每行都写
> 是最稳妥的写法。某些解析器也支持只在段落开头写一个 >：
⚠️ 注意： 为最大兼容性，建议每行都加
>。
(2) 引用中的空行
引用内空行也需加 >：
▶ 示例：标准引用用法
⚠️ 注意： 嵌套引用不要超过 3 层，否则可读性急剧下降。
▶ 示例：对话式嵌套引用
💡 提示： 嵌套引用适合模拟对话、多层评论，或者展示引用中的引用（如论文引用）。
5. 引用中的其他元素
(1) 引用中的标题
(2) 引用中的列表
(3) 引用中的代码块
▶ 示例：引用中嵌入多种内容
💡 提示： 引用内可以包含标题、列表、代码块、表格等大多数 Markdown 元素。这让引用不只是"一段灰色文字"，而是一个独立的内容块。
6. 引用 vs 提示框
Markdown 中的 > 和本教程常用的 > **💡 提示：** 都是引用语法，但用途不同：
| 类型 | 用法 | 外观 | 用途 |
|---|---|---|---|
| 标准引用 | > 文字 |
灰色竖线 | 引用外部资料、对话 |
| 提示框 | > **💡 提示：** 文字 |
灰色竖线+图标 | 重点提示、注意事项 |
| 警告框 | > **⚠️ 注意：** 文字 |
灰色竖线+图标 | 警告信息、易错点 |
💡 提示： 在技术文档中，引用外部资料用标准引用，重点提示用带 emoji 的提示框。两者分开使用，读者更易理解。
7. 引用在排版中的高级用法
(1) 用引用做"侧边栏"效果
(2) 引用中的引用（层层递进）
💡 提示： 多层引用在学术写作中常见，但在技术文档中建议不超过 2 层。信息层次越深，读者越容易迷失。
8. 完整示例：用引用组织技术评审文档
预期效果：一份专业的架构评审文档，引用清晰地划分了不同参与者的观点和最终决策。
❓ 常见问题
Q 引用和缩进有什么区别？
A 引用有左侧灰色竖线标记，视觉上独立成块；缩进只是整体偏移。使用引用表示"这是来自其他地方的内容"，使用缩进表示"这是正文的延续"。
Q 引用中可以放图片吗？
A 可以。
>  会渲染为引用内的图片。但大图在引用中可能挤占空间，慎用。Q 引用太长影响阅读怎么办？
A 精简引用内容，只保留最核心的文字。长篇引用不如总结成自己的话，然后在文末附上原文链接。
Q 提示框和引用的区别是什么？
A 提示框本质上也是引用语法，但加了 emoji 和加粗作为视觉增强。两者渲染为同样的 HTML blockquote 元素。
📖 小节
- 块引用用
>符号，每行都加确保兼容性 - 多层嵌套用
>>、>>>，不超过 3 层 - 引用内可嵌入标题、列表、代码块、表格
- 引用适合引述外部资料、突出重要信息
- 提示框是引用的增强版，增加了 emoji 和加粗区分
- 保持引用简洁，过长影响文档流畅度
📝 作业
-
基础题：用引用写一段书评，至少包含 2 段文字，中间有引用符号的空行隔开。
-
进阶题：创建一个双层嵌套引用，模拟"老师引用专家观点，学生再引用老师的解释"的场景。每层至少 2-3 行文字。
-
挑战题：写一篇"技术决策日志"，综合使用标准引用（引述外部资料）、提示框（⚠️ 注意风险）、表格（方案对比）、代码块（示例代码），全部放在一个引用块中，测试渲染效果。
