Skip to content

Markdown 引用块

引用块用于引用他人的话语、突出重要信息或创建特殊的内容区域。本章将详细介绍引用块的各种用法。

基本语法

使用 > 符号创建引用块:

markdown
> 这是一段引用文本。

效果:

这是一段引用文本。

多行引用

连续引用

每行都使用 >

markdown
> 第一行引用。
> 第二行引用。
> 第三行引用。

效果:

第一行引用。 第二行引用。 第三行引用。

段落引用

引用中包含多个段落:

markdown
> 第一段引用。
>
> 第二段引用。

效果:

第一段引用。

第二段引用。

嵌套引用

使用多个 > 创建嵌套引用:

markdown
> 第一层引用
>> 第二层引用
>>> 第三层引用

效果:

第一层引用

第二层引用

第三层引用

实际应用

markdown
> 原文:
>> 这是被引用的内容。
>
> 我的评论:这个观点很有道理。

引用中的其他元素

引用中的标题

markdown
> ## 引用标题
>
> 这是引用内容。

效果:

引用标题

这是引用内容。

引用中的列表

markdown
> 引用中的列表:
>
> - 项目一
> - 项目二
> - 项目三

效果:

引用中的列表:

  • 项目一
  • 项目二
  • 项目三

引用中的代码

markdown
> 使用以下命令:
>
> ```bash
> npm install
> ```

效果:

使用以下命令:

bash
npm install

引用中的链接

markdown
> 更多信息请访问 [官方文档](https://example.com)。

效果:

更多信息请访问 官方文档

引用样式

警告框

markdown
> ⚠️ **警告**
>
> 这是一个警告信息,请注意!

效果:

⚠️ 警告

这是一个警告信息,请注意!

提示框

markdown
> 💡 **提示**
>
> 这是一个有用的提示。

效果:

💡 提示

这是一个有用的提示。

注意框

markdown
> ⚡ **注意**
>
> 这是需要特别注意的内容。

效果:

注意

这是需要特别注意的内容。

信息框

markdown
> ℹ️ **信息**
>
> 这是一条信息提示。

效果:

ℹ️ 信息

这是一条信息提示。

引用应用场景

1. 引用名言

markdown
> "生活就像一盒巧克力,你永远不知道下一颗是什么味道。"
>
> —— 阿甘正传

效果:

"生活就像一盒巧克力,你永远不知道下一颗是什么味道。"

—— 阿甘正传

2. 引用文献

markdown
> 根据研究表明,Markdown 可以提高写作效率 30%。
>
> —— 《技术写作指南》,2024

3. 突出重点

markdown
> **重要提示**
>
> 在执行此操作前,请务必备份数据。

4. 代码注释

markdown
> **注意:** 以下代码仅适用于 Python 3.6+
>
> ```python
> def hello():
>     print("Hello, World!")
> ```

5. 版本说明

markdown
> **v2.0 新特性**
>
> - 支持暗黑模式
> - 优化性能
> - 修复已知问题

自定义引用样式

使用 HTML 和 CSS

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

使用 div 容器

markdown
<div style="background-color: #f0f0f0; padding: 1em; border-radius: 5px;">
<strong>提示:</strong> 这是一个自定义的提示框。
</div>

引用最佳实践

1. 保持简洁

markdown
✅ 推荐
> 简短的引用更容易阅读。

❌ 不推荐
> 这是一段非常非常非常非常非常非常非常非常非常非常非常非常非常非常非常非常非常非常非常非常长的引用文本。

2. 明确引用来源

markdown
✅ 推荐
> "知识就是力量。"
>
> —— 培根

❌ 不推荐
> "知识就是力量。"

3. 适当使用嵌套

markdown
✅ 推荐
> 原文
>> 引用

❌ 不推荐
> 一层
>> 二层
>>> 三层
>>>> 四层(太深了)

4. 引用前后空行

markdown
✅ 推荐
这是正文。

> 这是引用。

这是正文。

❌ 不推荐
这是正文。
> 这是引用。
这是正文。

特殊引用格式

GitHub 风格提示

某些平台支持特殊的提示语法:

markdown
> [!NOTE]
> 这是一个注意事项。

> [!TIP]
> 这是一个提示。

> [!IMPORTANT]
> 这是重要信息。

> [!WARNING]
> 这是警告信息。

> [!CAUTION]
> 这是需要谨慎的内容。

VitePress 风格提示

markdown
::: tip
这是一个提示
:::

::: warning
这是一个警告
:::

::: danger
这是一个危险警告
:::

::: info
这是一条信息
:::

引用与其他元素组合

引用 + 任务列表

markdown
> **待办事项**
>
> - [x] 完成文档
> - [ ] 代码审查
> - [ ] 部署上线

引用 + 表格

markdown
> **配置参数**
>
> | 参数 | 说明 | 默认值 |
> |------|------|--------|
> | port | 端口号 | 3000 |
> | host | 主机地址 | localhost |

引用 + 图片

markdown
> **效果预览**
>
> ![预览图](image.png)

引用的语义化使用

引用他人观点

markdown
> 正如爱因斯坦所说:"想象力比知识更重要。"

引用文档内容

markdown
> 根据官方文档:
>
> Markdown 是一种轻量级标记语言。

突出重要信息

markdown
> ⚠️ **重要**
>
> 此操作不可撤销,请谨慎操作。

补充说明

markdown
> **补充说明**
>
> 此功能在 v2.0 版本中引入。

常见问题

引用符号后的空格

建议在 > 后添加空格:

markdown
✅ 推荐
> 引用内容

❌ 不推荐
>引用内容

引用中的空行

引用中的空行也需要 >

markdown
✅ 推荐
> 第一段
>
> 第二段

❌ 不推荐
> 第一段

> 第二段

引用的结束

引用块以空行结束:

markdown
> 这是引用

这是正文

实践练习

尝试创建以下引用:

  1. 一个简单的引用块
  2. 一个包含多个段落的引用
  3. 一个嵌套引用
  4. 一个包含列表的引用
  5. 一个警告样式的引用框

引用快捷键

VS Code

  • 选中文本后,使用命令面板搜索 "Toggle Block Comment"

Typora

  • Ctrl/Cmd + Shift + Q:创建引用块

Obsidian

  • Ctrl/Cmd + <:创建引用块

小结

引用块是 Markdown 中重要的格式化工具,可以用于:

  • 引用他人的话语和观点
  • 突出重要信息和警告
  • 创建特殊的内容区域
  • 提高文档的可读性

合理使用引用块可以让你的文档更加清晰、专业。

下一步: 学习 Markdown 代码 的详细用法。