Markdown 引用块生成器
粘贴文字即可得到前缀正确的引用块,多行、多段落一次搞定。全部计算都在你的浏览器本地完成。
Markdown 中怎么写引用?
在行首加一个大于号和一个空格即可:`> 引用内容`。连续几行都加上这个前缀,它们就属于同一个引用块,最终渲染成缩进的 <blockquote> 元素。再加一个 `>` 可以嵌套引用,单独一行只写 `>` 则用来分隔同一引用块中的多个段落。
> 这是一段 Markdown 引用。
> 引用可以继续写在下一行。
>
> 这是同一个引用块中的第二个段落。渲染为一个缩进的引用块,内含两个段落,左侧通常带一条竖线。
在线使用 Markdown 引用块生成器
引用内容
输出结果
Markdown 引用块语法详解
引用块是一个「容器」,而不是一种行内样式。理解这一点,几乎就能解释所有引用相关的疑问:引用在哪里结束、嵌套怎么写、为什么其他 Markdown 语法在引用里照常生效。
基础引用
行首一个大于号,就把这一行的内容变成引用。大于号后面的空格并非强制,但所有风格指南和格式化工具都会补上。
> 简约是终极的复杂。渲染为一段缩进文字,对应 HTML 中的 <blockquote> 元素,左侧通常带一条竖线。
多行引用与惰性续行
最稳妥的写法是每一行都加前缀。CommonMark 还允许「惰性续行」:紧接在引用下方、没有加前缀的那一行会被吸进引用里——看起来省事,但只要中间出现一个空行就会失效。
> 每一行都显式加上前缀。
> 这是最清晰也最安全的写法。
> 惰性续行同样有效:
这一行没有前缀,但仍然属于上面的引用。结果是两个互相独立的引用块。第二个块里那一行没有前缀却被并入了引用——正是这种歧义,让「每行都加前缀」成为推荐做法。
同一引用中的多个段落
真正的空行会结束引用块。想让多个段落留在同一个引用里,分隔行上要单独写一个 >,这样容器就不会被关闭。
> 引用的第一个段落。
>
> 同一引用中的第二个段落。生成一个 <blockquote>,内含两个 <p>。如果把那一行单独的 > 删掉,就会变成两个毫无关联、上下堆叠的引用块。
嵌套引用
每多一层就多写一个 >。邮件回复和论坛盖楼就是用这种方式表示的——注意段落之间的分隔行也要写到对应层级,否则嵌套会被打断。
> 原始评论。
>
>> 下一层的回复。
>>
>>> 再下一层。
>
> 回到最外层。依次呈现三层缩进逐级加深的引用,最后回到最外层;HTML 中每一层都会多包一个 <blockquote>。
在引用中使用其他语法
既然引用块是容器,标题、列表、强调、表格、围栏代码块在里面都照常工作,唯一的要求是每一行都带上 > 前缀。
> ### 更新说明
>
> - 修复导出崩溃
> - **破坏性变更:**`--out` 参数已重命名
>
> ```bash
> npm i mdutil@latest
> ```一个引用块里同时包含标题、带粗体的无序列表和围栏代码块,全部位于同一段引用区域内。
标注引用出处
Markdown 没有专门的出处语法。惯例是在引用的最后一段写破折号加作者名,这样出处会跟着正文一起被引用。
> 预测未来最好的方式,就是把它创造出来。
>
> —— *Alan Kay*引文和出处留在同一个引用块内,视觉上始终保持关联,不会在复制时被拆散。
各平台对 Markdown 引用的支持
> 符号本身各处通用,但嵌套层级、多行简写和扩展的提示框语法差别不小,发布前值得确认。
| 平台 | 支持情况 | 说明 |
|---|---|---|
| GitHub / GitLab | 完全支持 | 支持嵌套和引用内嵌套其他语法;GitHub 还提供 > [!NOTE]、> [!WARNING] 等提示框。 |
| Discord | 完全支持 | > 只引用当前行,>>> 会把消息剩余内容全部引用;不支持嵌套。 |
| Slack | 部分支持 | 输入框中 > 可用,但所有层级都会被压平成一级缩进。 |
| Obsidian | 完全支持 | 支持完整嵌套,还支持首行写 > [!info] 标题 的 Callout 提示框。 |
| Notion | 部分支持 | 输入 > 加空格会生成引用块,但没有嵌套引用。 |
| 完全支持 | Markdown 编辑器中 > 可用且支持嵌套;富文本编辑器则提供引用按钮。 |
如何生成 Markdown 引用块
粘贴要引用的文字
在上方输入框中输入或粘贴文字,每输入一行就对应引用块中的一行。
用换行组织结构
按回车换行即可。工具会给每一行都加上 > 前缀,保证整段内容留在同一个引用块里,不会被拆成几块。
复制 Markdown
点击复制按钮获取生成的引用语法,可直接粘贴到 README、Issue、Pull Request 或笔记中。
核对预览
切换到预览标签页确认整段确实渲染成一个引用块;需要嵌套回复时,再手动补上额外的 > 即可。
常见问题
Markdown 引用块和普通引号有什么区别?
引用块是 Markdown 语法:> 会生成真正的 <blockquote> 元素,渲染时带缩进和样式。引号只是普通文本字符,没有任何结构含义。需要把引文与自己的正文在视觉和语义上分开时用引用块;句子中间的短引用用引号即可。
怎么写多行的 Markdown 引用?
给整段文字的每一行行首都加上 >。多数解析器也支持惰性续行,即只给第一行加前缀、后续行自动并入引用,但只要中间出现空行就会失效。逐行加前缀是兼容性最好的写法。
Markdown 怎么做嵌套引用?
每多一层就多加一个 >,第二层是 >>,第三层是 >>>。段落之间的分隔行也要写到相同层级:只写一个 > 的分隔行会把层级拉回第一层,这正是嵌套引用意外「塌陷」最常见的原因。
怎样让多个段落属于同一个引用块?
段落之间的分隔行只写一个 >,不要留空。完全空白的行会结束引用块,因此用空行分隔的两个段落会变成两个独立引用,而不是一个包含两段的引用。
GitHub 上的引用块是什么样子?
GitHub 在 README、Issue、Pull Request、评论和 Wiki 中都把引用渲染成左侧带灰色竖线、文字为浅灰色的区块。GitHub 还支持提示框:首行写 [!NOTE]、[!TIP]、[!IMPORTANT]、[!WARNING] 或 [!CAUTION] 的引用块,会被渲染成带颜色的提示卡片。
Discord 支持 Markdown 引用吗?
支持。> 加空格只引用当前这一行;消息开头写 >>> 则会把后面的全部内容都变成引用,直到消息结束。Discord 不支持嵌套引用,写 >> 只会得到一级引用,里面多出一个字面的 > 字符。
Markdown 引用怎么标注出处?
Markdown 没有专门的出处语法。常见做法是在引用块的最后一段写破折号加作者名,例如单独一行写 > —— Alan Kay。把出处放在引用块内部,它才会和被引用的内容保持视觉上的关联。
引用块里能放列表、代码块和粗体吗?
可以。引用块是块级容器,标题、列表、表格、围栏代码块和行内强调在里面都能正常工作。唯一的要求是内部每一行都要带 > 前缀,包括列表项之间和代码围栏前后的空行。
为什么我的引用块没有在预期的位置结束?
几乎都是惰性续行造成的。如果引用下面紧挨着的段落中间没有空行,解析器会把它当成引用的延续一并吸进去。在最后一行引用之后插入一个空行,或者给后面的文字显式加上前缀,就能把两个块断开。
可以自定义引用块的样式吗?
在 Markdown 里不行。外观完全由渲染方的 CSS 决定,所以在 GitHub、Discord、Notion 上只能使用它们的内置样式。如果是自己的站点,可以在 CSS 中针对 blockquote 元素定制;部分平台还提供 Callout 扩展,能得到带配色的提示框变体。