Skip to content

引用语法

引用(Blockquote)用于突出显示引用的文本或强调重要信息。在 Markdown 中,使用 > 符号创建引用块。

基本引用语法

单行引用

使用 > 符号在行首创建引用:

markdown
> 这是一个引用块。

渲染效果

这是一个引用块。

多行引用

markdown
> 这是引用的第一行。
> 这是引用的第二行。
> 这是引用的第三行。

渲染效果

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

段落引用

在引用中包含多个段落:

markdown
> 这是引用的第一段。
>
> 这是引用的第二段。

渲染效果

这是引用的第一段。

这是引用的第二段。

嵌套引用

基本嵌套

使用 >> 创建嵌套引用:

markdown
> 这是第一级引用。
>
> > 这是第二级引用。
>
> 回到第一级引用。

渲染效果

这是第一级引用。

这是第二级引用。

回到第一级引用。

多层嵌套

markdown
> 第一级引用
> > 第二级引用
> > > 第三级引用
> > > > 第四级引用
> >
> > 回到第二级
>
> 回到第一级

渲染效果

第一级引用

第二级引用

第三级引用

第四级引用

回到第二级

回到第一级

引用中的其他元素

引用中的格式化

markdown
> **粗体文本***斜体文本* 在引用中正常工作。
> 
> 你可以使用 `行内代码` 和其他格式。

渲染效果

粗体文本斜体文本 在引用中正常工作。

你可以使用 行内代码 和其他格式。

引用中的标题

markdown
> ## 引用中的标题
> 
> 这是引用中的正文内容。
> 
> ### 子标题
> 
> 更多引用内容。

渲染效果

引用中的标题

这是引用中的正文内容。

子标题

更多引用内容。

引用中的列表

markdown
> 引用中的列表:
> 
> 1. 第一项
> 2. 第二项
> 3. 第三项
> 
> 或者无序列表:
> 
> - 项目 A
> - 项目 B
> - 项目 C

渲染效果

引用中的列表:

  1. 第一项
  2. 第二项
  3. 第三项

或者无序列表:

  • 项目 A
  • 项目 B
  • 项目 C

引用中的代码块

markdown
> 以下是代码示例:
> 
> ```javascript
> function hello() {
>   console.log("Hello, World!");
> }
> ```
> 
> 代码块在引用中也能正常显示。

渲染效果

以下是代码示例:

javascript
function hello() {
  console.log("Hello, World!");
}

代码块在引用中也能正常显示。

引用中的链接

markdown
> 查看 [官方文档](https://www.markdownlang.com) 获取更多信息。
> 
> 也可以访问 <https://www.markdownlang.com> 直接链接。

渲染效果

查看 官方文档 获取更多信息。

也可以访问 https://www.markdownlang.com 直接链接。

常见用法场景

1. 文献引用

markdown
> "Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档。"
> 
> —— John Gruber,Markdown 创始人

渲染效果

"Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档。"

—— John Gruber,Markdown 创始人

2. 警告信息

markdown
> ⚠️ **警告**
> 
> 执行此操作将删除所有数据,请确保已备份重要文件。

渲染效果

⚠️ 警告

执行此操作将删除所有数据,请确保已备份重要文件。

3. 提示信息

markdown
> 💡 **提示**
> 
> 使用快捷键 `Ctrl+S` 可以快速保存文档。

渲染效果

💡 提示

使用快捷键 Ctrl+S 可以快速保存文档。

4. 重要说明

markdown
> 📌 **重要说明**
> 
> 在开始之前,请确保你已经安装了以下依赖:
> 
> - Node.js (>= 14.0)
> - npm (>= 6.0)
> - Git

渲染效果

📌 重要说明

在开始之前,请确保你已经安装了以下依赖:

  • Node.js (>= 14.0)
  • npm (>= 6.0)
  • Git

常见错误和解决方案

1. 遗漏 > 符号

markdown
❌ 错误:
> 第一行引用
第二行忘记了 > 符号  ← 这行不会被包含在引用中

✅ 正确:
> 第一行引用
> 第二行正确的引用

2. 嵌套层级错误

markdown
❌ 错误:
> 第一级
> > > 直接跳到第三级  ← 跳过了第二级

✅ 正确:
> 第一级
> > 第二级
> > > 第三级

3. 空行处理

markdown
❌ 可能有问题:
> 第一段

> 第二段  ← 这会创建两个独立的引用块

✅ 正确的多段落引用:
> 第一段
>
> 第二段

最佳实践

1. 保持一致的风格

markdown
✅ 推荐:统一的引用风格
> 重要信息都使用引用块
> 保持格式一致

❌ 不推荐:混合使用
> 有时用引用
**有时用粗体代替**

2. 适度使用嵌套

markdown
✅ 推荐:简单清晰的嵌套
> 主要观点
> > 支持论据
> 
> 继续主要观点

❌ 不推荐:过深的嵌套
> > > > > 太深了,难以阅读

3. 语义化使用

markdown
✅ 推荐:有意义的引用
> 这是来自权威文档的重要信息

❌ 不推荐:装饰性引用
> 这只是普通文本,不需要引用格式

HTML 输出

Markdown 引用转换为 HTML:

markdown
> 这是引用文本

转换为:

html
<blockquote>
  <p>这是引用文本</p>
</blockquote>

嵌套引用:

markdown
> 第一级
> > 第二级

转换为:

html
<blockquote>
  <p>第一级</p>
  <blockquote>
    <p>第二级</p>
  </blockquote>
</blockquote>

自定义样式

某些 Markdown 处理器支持自定义引用样式:

GitHub 风格的提示框

markdown
> [!NOTE]
> 这是一个信息提示

> [!WARNING]
> 这是一个警告提示

> [!IMPORTANT]
> 这是一个重要提示

使用 HTML 和 CSS

markdown
<blockquote style="border-left: 4px solid #3498db; padding-left: 1em; color: #7f8c8d;">
这是自定义样式的引用块
</blockquote>

实用示例

API 文档中的示例

markdown
## 用户认证

用户认证是访问 API 的必要步骤。

> **认证方式**
> 
> 我们的 API 使用 Bearer Token 进行认证:
> 
> ```bash
> curl -H "Authorization: Bearer YOUR_TOKEN" \
>      https://api.example.com/users
> ```

### 请求示例

发送 POST 请求创建用户:

> ```json
> {
>   "name": "张三",
>   "email": "zhangsan@example.com",
>   "role": "user"
> }
> ```

教程中的注意事项

markdown
## 安装步骤

1. 下载安装包
2. 运行安装程序

> ⚠️ **注意**
> 
> 安装前请确保:
> - 关闭杀毒软件
> - 以管理员身份运行
> - 系统磁盘至少有 2GB 空间

3. 按照向导完成安装

相关语法

练习

尝试创建以下内容:

  1. 一个包含多个段落的引用块
  2. 一个三级嵌套的引用结构
  3. 一个包含代码示例的技术说明引用
  4. 一个模拟对话的嵌套引用

由 Markdownlang.com 整理创建