1.4 引用块

学习 Markdown 引用块写法,掌握单级、多级嵌套及与列表和代码块组合。

字数 905 字

引用块语法概览

引用块(Blockquote)用于标记“引用内容”或“补充说明”。
核心写法是在行首使用 >,后面加一个空格。

1
> 这是一段引用

单级引用

基本写法

1
2
> 区块引用
> 学的不仅是技术,更是思路

渲染效果:

区块引用 学的不仅是技术,更是思路

多行与多段落

多段落时,空行也建议带上 >,可读性更好,也更稳定。

1
2
3
4
> 这是引用的第一行。  
> 这是引用的第二行。
>
> 这是引用的第二段。

渲染效果:

这是引用的第一行。
这是引用的第二行。

这是引用的第二段。

懒惰续行(可选写法)

CommonMark 支持“懒惰续行”:段落续行可以省略 >
但为了兼容不同解析器,实际写作中仍建议每一行都写 >

1
2
3
> 这是一个长引用,
包含多行内容,
这是懒惰续行写法。

渲染效果:

这是一个长引用, 包含多行内容, 这是懒惰续行写法。

多级嵌套引用

一个 > 是第一层,两个 >> 是第二层,三个 >>> 是第三层。

1
2
3
> 最外层
>> 第一层嵌套
>>> 第二层嵌套

渲染效果:

最外层

第一层嵌套

第二层嵌套

实际应用示例

1
2
3
4
5
> **用户反馈**:这个功能很有用!
>
>> **开发团队回复**:感谢反馈,我们会继续优化。
>>
>>> **项目经理补充**:预计下个版本会增加更多改进。

渲染效果:

用户反馈:这个功能很有用!

开发团队回复:感谢反馈,我们会继续优化。

项目经理补充:预计下个版本会增加更多改进。

引用块与其他元素组合

引用块中使用列表

1
2
3
4
5
6
7
8
> 今日计划:
> 1. 阅读文档
> 2. 整理笔记
> 3. 输出总结
>
> 待办清单:
> - 完成示例
> - 提交修改

渲染效果:

今日计划:

  1. 阅读文档
  2. 整理笔记
  3. 输出总结

待办清单:

  • 完成示例
  • 提交修改

列表中使用引用块

在列表项中放引用块时,要注意缩进对齐。

1
2
3
4
1. 第一项
   > 这是第一项的补充说明
   > 这是第二行说明
2. 第二项

渲染效果:

  1. 第一项

    这是第一项的补充说明 这是第二行说明

  2. 第二项

引用块中使用代码块

1
2
3
4
5
6
> 执行以下命令启动项目:
>
> ```bash
> npm install
> npm run dev
> ```

渲染效果:

执行以下命令启动项目:

1
2
npm install
npm run dev

常见错误

  1. > 后面忘记加空格,导致语法可读性差或渲染不一致。
  2. 使用全角符号 代替半角 >,导致引用失效。
  3. 列表中嵌套引用时缩进不足,导致结构错位。
  4. 多段落引用时空行没带 >,在部分解析器中可能意外“跳出引用块”。
使用 Hugo 构建
主题 StackJimmy 设计 由 Hobin 魔改
载入天数...载入时分秒...
发表了 0 篇文章 · 发表了 46 篇笔记 · 总计 2 万 5 千字(其中笔记 25104 字)