Markdown 引用(六)

6.引用

涵盖基本语法、嵌套、与其他元素混用及最佳实践。

引用用于突出显示重要信息、引用他人观点或创建视觉层次。

一、单级引用

使用 >​ 符号,后跟一个空格

> 区块引用
> 菜鸟教程
> 学的不仅是技术更是梦想

多行简化写法:只需在第一行写 >,后续行会自动包含在引用中。

> 这是一个长引用,
包含多行内容,
只需要在第一行使用 > 符号。

多段落引用:段落间用空行分隔,空行上也需写 >

> 这是第一段。
>
> 这是第二段。

二、多级嵌套引用

  • > 最外层
  • > > 第一层嵌套
  • > > > 第二层嵌套(以此类推)
> 最外层
> > 第一层嵌套
> > > 第二层嵌套

实际应用示例

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

三、引用与列表混用

3.1 引用中包含列表

直接在引用内写列表语法即可。

> 区块中使用列表
> 1. 第一项
> 2. 第二项
> + 无序项
> + 另一项

3.2 列表中包含引用

需要在 >​ 前添加 4 个空格(与列表项缩进对齐)。

* 第一项
    > 菜鸟教程
    > 学的不仅是技术更是梦想
* 第二项

四、引用内的其他元素

引用可以包含标题、列表、代码块、链接、图片等几乎所有 Markdown 元素。

1.包含标题

> ## 重要提醒
> 请在操作前仔细阅读文档。

2.包含代码块

> 运行以下命令:
> ‍```bash
> npm install
> npm start
> ‍```

3.包含链接和图片

> 参考 [官方文档](https://example.com)
> ![示例图片](./images/example.png)

五、常见引用场景

1.名言警句

> "在软件开发中,最昂贵的错误就是构建正确的系统错误的方式。"
> 
> — Barry Boehm

2.信息提示

类型 示例
✅ 成功 > ✅ **成功** 配置已保存。
⚠️ 警告 > ⚠️ **警告** 此操作不可逆转。
❌ 错误 > ❌ **错误** 数据库连接失败。
ℹ️ 提示 > ℹ️ **提示** 验证邮件已发送。

3.章节摘要 / 版本说明

> **本章要点**
> - 项目背景
> - 核心功能
> - 技术架构

总结速查表

用法 语法
单行引用 > 内容
多行引用 每行前加 >
多段落引用 段落间空行也需写 >
嵌套引用 > 外层​ → > > 内层
引用内列表 正常写列表语法
列表内引用 列表项​ 换行 + 4 空格 + >
引用内代码块 标准三个反引号
引用内标题/链接 标准 Markdown 语法

关键规则> 后紧跟一个空格,缩进使用 4 个空格(列表内引用时)。