Markdown: Markdown 引用语法与嵌套
引用让你的文档更有说服力——无论是在文章中引用专家观点，还是突出重要提示，块引用都是最好的方式。
1. 你将学到
- 块引用的基本语法和写法
- 多段引用和嵌套引用
- 引用内嵌入列表、代码、标题
- 引用在排版中的最佳实践
- 引用与提示框的区别
2. 一个技术作家培训师的真实故事
(1) 痛点：引用的错误用法
Jordan 在给技术团队做文档写作培训时，发现几乎所有人都在用错误的方式做"引用"——有人用灰色字体手动加缩进，有人用斜体文字，有人甚至直接用截图贴上别人的文字。文档中引用和正文混在一起，读者分不清哪些是作者的原话、哪些是引用的外部资料。
(2) 解法：用 > 统一引用格式
Jordan 给团队定了一个规矩：所有引用的外部文字、重要提示、警告信息，一律用 > 块引用语法。团队门禁脚本会检查是否使用标准引用格式。三个月后，文档的引用一致性从 30% 提升到 98%。
3. 块引用基础
(1) 基本语法
用 > 在行首表示引用：
MARKDOWN
> 这是一段引用文字。
> 引用的第二行。
💡 提示： 每行都写
> 是最稳妥的写法。某些解析器也支持只在段落开头写一个 >：
MARKDOWN
> 这是只有第一行有 > 符号的引用段落。
这是同一引用内的后续行（某些解析器支持）。
⚠️ 注意： 为最大兼容性，建议每行都加
>。
(2) 引用中的空行
引用内空行也需加 >：
MARKDOWN
> 第一段文字。
>
> 第二段文字（中间空了一行，但加了 `>` 符号）。
▶ 示例：标准引用用法
MARKDOWN
在《The Pragmatic Programmer》中，作者指出：
> 软件开发的核心不是写代码，而是管理复杂度。
> 好的程序员不是写代码最多的人，而是让代码最清晰的人。
⚠️ 注意： 嵌套引用不要超过 3 层，否则可读性急剧下降。
▶ 示例：对话式嵌套引用
MARKDOWN
> **项目经理：** 这个功能这周五能上线吗？
>
> > **开发者：** 核心功能没问题，但还有些边缘情况需要测试。
> >
> > > **测试工程师：** 我已经跑了 80% 的用例，预计周三能出结果。
💡 提示： 嵌套引用适合模拟对话、多层评论，或者展示引用中的引用（如论文引用）。
5. 引用中的其他元素
(1) 引用中的标题
MARKDOWN
> ## 引用的核心观点
>
> 这里是引用的正文内容。
>
> ### 子观点 1
>
> 子观点的详细说明。
(2) 引用中的列表
MARKDOWN
> 项目要求：
>
> - 支持 1000 并发用户
> - 响应时间 < 200ms
> - 可用性 99.9%
(3) 引用中的代码块
MARKDOWN
> **核心算法：**
>
> ```python
> def fibonacci(n):
> if n <= 1:
> return n
> return fibonacci(n-1) + fibonacci(n-2)
> ```
>
> 以上算法的时间复杂度为 O(2^n)，可用动态规划优化。
▶ 示例：引用中嵌入多种内容
MARKDOWN
> ## 技术方案评审结果
>
> 经过团队评估，我们决定采用 **微服务架构**。
>
> | 方案 | 扩展性 | 维护成本 |
> |:-----|:------:|:--------:|
> | 单体 | 低 | 低 |
> | 微服务 | 高 | 高 |
>
> > 注：微服务适合 10 人以上团队。小团队建议从单体开始。
💡 提示： 引用内可以包含标题、列表、代码块、表格等大多数 Markdown 元素。这让引用不只是"一段灰色文字"，而是一个独立的内容块。
6. 引用 vs 提示框
Markdown 中的 > 和本教程常用的 > **💡 提示：** 都是引用语法，但用途不同：
| 类型 | 用法 | 外观 | 用途 |
|---|---|---|---|
| 标准引用 | > 文字 |
灰色竖线 | 引用外部资料、对话 |
| 提示框 | > **💡 提示：** 文字 |
灰色竖线+图标 | 重点提示、注意事项 |
| 警告框 | > **⚠️ 注意：** 文字 |
灰色竖线+图标 | 警告信息、易错点 |
MARKDOWN
> 普通引用：引用外部作者的观点。
> **💡 提示：** 这是提示框——强调关键信息，让读者特别注意。
> **⚠️ 注意：** 这是警告框——提醒风险，避免读者踩坑。
💡 提示： 在技术文档中，引用外部资料用标准引用，重点提示用带 emoji 的提示框。两者分开使用，读者更易理解。
7. 引用在排版中的高级用法
(1) 用引用做"侧边栏"效果
MARKDOWN
## 关键决策
我们选择 PostgreSQL 作为主要数据库。
> **决策依据：**
> 1. 团队已有 3 年 PostgreSQL 使用经验
> 2. 项目需要复杂查询和事务支持
> 3. 预算有限，PostgreSQL 开源免费
(2) 引用中的引用（层层递进）
MARKDOWN
原始论文指出：
> 实验结果表明该方法有效。
>
> > 后续研究进一步证实：
> >
> > > 经过 10 次独立重复实验，结果一致。
💡 提示： 多层引用在学术写作中常见，但在技术文档中建议不超过 2 层。信息层次越深，读者越容易迷失。
8. 完整示例：用引用组织技术评审文档
MARKDOWN
# 架构评审报告
## 评审结论
经过 2026 年 6 月 15 日的架构评审会议，团队做出以下决定：
## 数据库选型
> **最终决定：** 采用 PostgreSQL。
>
> **理由：**
> - 项目需要复杂的地理空间查询（PostGIS）
> - 团队 PostgreSQL 经验丰富
> - 相比 MongoDB，PostgreSQL 的事务支持更完善
>
> | 对比项 | PostgreSQL | MongoDB |
> |:-------|:----------:|:-------:|
> | 事务 | ✅ ACID | ✅ 多文档 |
> | 地理查询 | ✅ PostGIS | ✅ 内置 |
> | 团队经验 | 3 年 | 1 年 |
## 部署方案
> **CEO 的意见：**
>
> > 我建议先上单体架构，等用户量起来再拆分。
>
> **技术团队的回应：**
> 我们同意这个策略。但数据库连接层会用独立模块，方便未来拆分为微服务。
## 提醒事项
> **⚠️ 注意：** 迁移过程中需要保持旧系统同时运行至少 2 周，确保数据完整性。
预期效果：一份专业的架构评审文档，引用清晰地划分了不同参与者的观点和最终决策。
❓ 常见问题
Q 引用和缩进有什么区别？
A 引用有左侧灰色竖线标记，视觉上独立成块；缩进只是整体偏移。使用引用表示"这是来自其他地方的内容"，使用缩进表示"这是正文的延续"。
Q 引用中可以放图片吗？
A 可以。
>  会渲染为引用内的图片。但大图在引用中可能挤占空间，慎用。Q 引用太长影响阅读怎么办？
A 精简引用内容，只保留最核心的文字。长篇引用不如总结成自己的话，然后在文末附上原文链接。
Q 提示框和引用的区别是什么？
A 提示框本质上也是引用语法，但加了 emoji 和加粗作为视觉增强。两者渲染为同样的 HTML blockquote 元素。
📖 小节
- 块引用用
>符号，每行都加确保兼容性 - 多层嵌套用
>>、>>>，不超过 3 层 - 引用内可嵌入标题、列表、代码块、表格
- 引用适合引述外部资料、突出重要信息
- 提示框是引用的增强版，增加了 emoji 和加粗区分
- 保持引用简洁，过长影响文档流畅度
📝 作业
-
基础题：用引用写一段书评，至少包含 2 段文字，中间有引用符号的空行隔开。
-
进阶题：创建一个双层嵌套引用，模拟"老师引用专家观点，学生再引用老师的解释"的场景。每层至少 2-3 行文字。
-
挑战题：写一篇"技术决策日志"，综合使用标准引用（引述外部资料）、提示框（⚠️ 注意风险）、表格（方案对比）、代码块（示例代码），全部放在一个引用块中，测试渲染效果。
