Markdown 引用
引用块(blockquote)用于展示别人的话、原文摘录、注释说明。它的渲染风格通常是左侧带一条竖线、文字缩进——视觉上很明显。语法只用一个 > 符号,但里面有不少细节。这一章讲清楚。
1. 单行引用
行首加 > 和一个空格,就是一行引用:
> 这是单行引用。
渲染为 HTML 的 <blockquote> 标签。
渲染结果是 HTML 的 <blockquote> 标签,自带左侧边框和缩进样式。
2. 多行引用
多行引用有两种写法——每行都加 > 或只在第一行加:
> 第一行引用。
> 第二行引用。
> 第三行引用。
或者懒惰写法(只在第一行加 >):
> 第一行引用。
第二行引用。
第三行引用。
两种写法渲染结果相同。
两种渲染结果相同。第一种"每行都加"更安全、可读性更好,强烈推荐;第二种"懒惰写法"在跨段落、嵌套时容易出错。
3. 引用里的多段落
引用里想分多段?段落之间的空行也要加 >:
> 引用里的第一段。
>
> 引用里的第二段(中间空行也要加 >)。
>
> 第三段。
注意:空行不加 > 会结束引用。
这是新手最容易踩的坑——空行不加 >,引用就提前结束了。
4. 嵌套引用
多个 > 叠加就是嵌套引用,常用于"引用中的引用":
> 外层引用
>> 内层引用
>>> 更深一层
或者带空格的清晰写法:
> 外层
> > 内层
> > > 更深
第二种带空格的写法更清晰,推荐使用。
5. 引用里嵌套其他 Markdown
引用块里可以放几乎任何 Markdown 语法——标题、列表、链接、图片、代码块:
> ## 引用里的标题
>
> 引用里可以包含 **粗体**、*斜体*、`代码`。
>
> - 列表项 1
> - 列表项 2
>
> 还可以有 [链接](https://example.com) 和图片。
6. 引用里放代码块
这是最棘手的一种——代码块需要缩进 5 个空格(> + 4 个空格),或者用围栏式:
> 引用里放代码块需要缩进:
>
> let x = 1;
> console.log(x);
>
> 或者用围栏(推荐):
>
> ```javascript
> let x = 1;
> ```
注意围栏式的 ``` 前面也要加 >,否则代码块会"逃出"引用。
7. 最佳实践
✅ 推荐:每行都加 >
> 第一行
> 第二行
(清晰,不容易出错)
✅ 推荐:引用前后留空行
(避免和段落粘连)
✅ 邮件回复式引用:
> 原文
我的回复
❌ 避免:长段落只在开头加 >
(虽然语法允许,但部分引擎可能出错)
8. 常见坑
- 空行忘加
>:导致引用提前结束,后续段落变回普通文字。 - 引用紧贴前文:引用前必须有空行,否则会被并入段落。
- 列表里嵌引用没缩进:列表项里的引用必须缩进到列表标记之后,否则跳出列表。
- 嵌套层级混乱:
>>和> >在某些引擎里行为不同,统一用带空格的写法。 - 滥用引用做装饰:引用是语义,不是装饰。想突出框框,请用警告框(下一篇会讲)。
9. 实战:邮件式回复
引用最经典的场景是邮件/Issue 回复——贴出对方原话,下面写自己的回复:
- 用
>引用对方原话。 - 空一行后写自己的回复。
- 多段对话就交替使用引用和正文。
这种风格在 GitHub Issue、邮件列表、Usenet 时代就已是事实标准。
小结
引用块语法简单但用途广泛——摘录、注释、回复、强调旁注都靠它。下一篇是最后一站:GitHub 扩展语法,把警告框、脚注、Mermaid 图表一网打尽。
← 上一篇 表格
下一篇 GitHub 扩展 →