引用块语法概览
引用块(Blockquote)用于标记“引用内容”或“补充说明”。
核心写法是在行首使用 >,后面加一个空格。
| |
单级引用
基本写法
| |
渲染效果:
区块引用 学的不仅是技术,更是思路
多行与多段落
多段落时,空行也建议带上 >,可读性更好,也更稳定。
| |
渲染效果:
这是引用的第一行。
这是引用的第二行。这是引用的第二段。
懒惰续行(可选写法)
CommonMark 支持“懒惰续行”:段落续行可以省略 >。
但为了兼容不同解析器,实际写作中仍建议每一行都写 >。
| |
渲染效果:
这是一个长引用, 包含多行内容, 这是懒惰续行写法。
多级嵌套引用
一个 > 是第一层,两个 >> 是第二层,三个 >>> 是第三层。
| |
渲染效果:
最外层
第一层嵌套
第二层嵌套
实际应用示例
| |
渲染效果:
用户反馈:这个功能很有用!
开发团队回复:感谢反馈,我们会继续优化。
项目经理补充:预计下个版本会增加更多改进。
引用块与其他元素组合
引用块中使用列表
| |
渲染效果:
今日计划:
- 阅读文档
- 整理笔记
- 输出总结
待办清单:
- 完成示例
- 提交修改
列表中使用引用块
在列表项中放引用块时,要注意缩进对齐。
| |
渲染效果:
- 第一项
这是第一项的补充说明 这是第二行说明
- 第二项
引用块中使用代码块
| |
渲染效果:
执行以下命令启动项目:
1 2npm install npm run dev
常见错误
>后面忘记加空格,导致语法可读性差或渲染不一致。- 使用全角符号
>代替半角>,导致引用失效。 - 列表中嵌套引用时缩进不足,导致结构错位。
- 多段落引用时空行没带
>,在部分解析器中可能意外“跳出引用块”。