1.4 引用块：把别人的话放进框里

1.4 引用块：把别人的话放进框里

引用块用大于号加空格开头，渲染成带竖线的缩进区块。它远不只是"引用名人名言"——提示、警告、背景补充、来函摘录，都是它的用武之地。

一个大于号就能开始

> 原文出处：某设计文档第 3 节。
> 该方案在高峰期将请求排队，避免下游过载。
​

渲染后这两行同处一个引用区块。注意：每行都要以 > 开头，只写第一行的话，第二行会掉出区块。偷懒写法是"懒续行"——区块内段落第一行带 >、后续行省略，解析器会自动并入，但跨空行就失效了。稳妥起见，每行都写。

嵌套引用：大于号叠大于号

> 甲的原文观点。
>> 乙的反驳：这个前提在分布式场景下不成立。
>>> 丙的补充：实测数据支持乙的判断。
​

每多一层 > 就多一层缩进竖线。讨论记录、多层批注用它非常顺手——你正在读的这个教程里，每节开头的"摘要"和结尾的"金句"也都是引用块，它天生适合"从正文里跳出来"的内容。

引用块里装整个小世界

引用块内部可以放几乎任何块级语法：

> #### 季度结论
>
> - 营收增长 12%
> - 新增客户 40 家
>
> ```text
> 明年目标：增长 20%
> ```
​

注意块内的空行也要写成单独的 >，否则区块在那里断开。

三种实际用法对比

💡 关键直觉：判断该不该用引用块，就问"这段话要不要在视觉上脱离正文流"。要，就用它；只是普通补充说明，留在正文里反而干净。

退出引用块的时机

引用块之后紧跟一行不以 > 开头的非空行，区块即结束。如果发现后面的正文"莫名缩在框里"，检查是不是有空行漏了 > 却又紧跟了引用内容——更常见的其实是反过来的问题：本想结束区块，却继续敲了带 > 的行。

引用块的边界纪律

引用块最容易失控的地方是"框越用越多"。一页文档里出现四五个引用块，"脱离正文流"的强调作用就互相抵消了——当所有内容都想跳出来，等于没有任何内容跳出来。给团队的建议是按内容来源划界：只有"不是本文作者当下写的"内容才进引用块——别人的原话、别处文档的摘录、历史版本的表述；而"本文作者当下写的提示与警告"，在有扩展语法的环境里优先用专门的提示容器（很多平台提供 :::warning 一类写法），没有扩展时再用引用块加图标符号的约定写法。来源纪律一立，引用块在整个文档里的密度自然降下来。

引用别人的内容还有一条容易忽略的责任：保留出处。引用块里裸放一段摘录、不写来源，半年后没人说得清这段话是谁在什么场合说的，讨论语境一旦丢失，摘录的效力就归零。惯用做法是引用块末行以破折号带出处（人名加文档名或链接），嵌套讨论记录则在每个 > 层级的第一行写发言人。另外，引用块做"警告框"时图标语义要统一：⚠️ 表示会造成损失的操作，💡 表示经验提示，两者不混用——符号一旦承担了语义，乱用比不用更糟，读者建立不起稳定的预期。

引用块与提示容器的渲染差异

同一句警告，三种写法在不同平台的表现值得对比一遍：

> ⚠️ 该操作不可回滚

:::warning
该操作不可回滚
:::

> [!WARNING]
> 该操作不可回滚
​

第一种是所有环境都认的通用写法，缺点只是"长得像引用"；第二种是很多静态站点生成器（mkdocs-material、VitePress 等）支持的容器语法，能渲染出带配色的提示框；第三种是 Obsidian 的标注语法，GitHub 讨论区也已支持。跨平台发布时的策略是：源码统一用通用引用块写法，容器语法交给平台的构建环节去增强——比如 VitePress 里配置容器插件，把 > ⚠️ 开头的引用块自动转换成提示组件。这样源码本身保持可移植，不绑死在任何一家方言上。

引用块与列表的组合还有一个高频细节：引用块里放列表容易，列表项里放引用块则需要缩进配合——引用块的 > 必须缩进到与列表项文字对齐的列，否则引用块会"打断"列表，后面的列表项被重新编号。写会议纪要类文档（列表项里嵌讨论摘录）时最容易踩到。动手验证一段：

1. 议题一：预算调整
   > 财务意见：Q3 追加需走加急流程。
   > 历史口径：去年同类追加平均 5 个工作日。
2. 议题二：供应商续约
​

两个议项之间夹着的引用块缩进对齐了列表文字列，编号 1、2 保持连续；把 > 顶格写一次，就能看到编号断开的反例。

本节要点回顾

• > 开头，每行都带；嵌套用 >>。
• 块内空行写成单独的 >，块内可放标题、列表、代码块。
• 定位：让内容脱离正文流的视觉装置，摘要/警告/讨论皆宜。
• 排错口诀：内容缩在框里查多余的 >，内容掉出框查漏掉的 >。

引用块的视觉重量控制

引用块自带缩进与竖线，视觉重量不低，长内容进引用块时有两个减负技巧。其一是块内首行用小标题（> #### 议题），让竖线框内的内容有内部结构，读者的眼睛有落点；其二是长摘录分段，每隔五到八行插入一个单独的 > 空行，连续竖线被切断后阅读压迫感明显下降。会议纪要多方讨论用嵌套引用时还有个分工写法：每层首行写发言人，正文只放其观点，层级与身份一一对应，事后检索"某人说过什么"时直接按层扫即可。这些细节不改变语法，却直接决定读者是否愿意读完一个引用块。

摘要引用块的写法模板

本教程每节开头的"摘要引用块"是个值得直接抄走的模式，它的结构是三段式：> **一句黑体结论**——补充半句适用条件或机制。黑体句承担"扫读者三秒获得本节结论"的职能，破折号后的普通文字补充范围。这个模板的好处是把"摘要"从一整段压缩到两句，既保持信息密度又不过度抢占篇幅。团队文档可以直接把它定为"每节必配摘要"的规范形态——比起放任各人自由发挥的开篇，统一模板让全库文档的扫读体验一致，读者建立"看黑体句即得结论"的稳定预期。