引用语法
引用(Blockquote)用于突出显示引用的文本或强调重要信息。在 Markdown 中,使用 >
符号创建引用块。
基本引用语法
单行引用
使用 >
符号在行首创建引用:
markdown
> 这是一个引用块。
渲染效果:
这是一个引用块。
多行引用
markdown
> 这是引用的第一行。
> 这是引用的第二行。
> 这是引用的第三行。
渲染效果:
这是引用的第一行。 这是引用的第二行。 这是引用的第三行。
段落引用
在引用中包含多个段落:
markdown
> 这是引用的第一段。
>
> 这是引用的第二段。
渲染效果:
这是引用的第一段。
这是引用的第二段。
嵌套引用
基本嵌套
使用 >>
创建嵌套引用:
markdown
> 这是第一级引用。
>
> > 这是第二级引用。
>
> 回到第一级引用。
渲染效果:
这是第一级引用。
这是第二级引用。
回到第一级引用。
多层嵌套
markdown
> 第一级引用
> > 第二级引用
> > > 第三级引用
> > > > 第四级引用
> >
> > 回到第二级
>
> 回到第一级
渲染效果:
第一级引用
第二级引用
第三级引用
第四级引用
回到第二级
回到第一级
引用中的其他元素
引用中的格式化
markdown
> **粗体文本** 和 *斜体文本* 在引用中正常工作。
>
> 你可以使用 `行内代码` 和其他格式。
渲染效果:
粗体文本 和 斜体文本 在引用中正常工作。
你可以使用
行内代码
和其他格式。
引用中的标题
markdown
> ## 引用中的标题
>
> 这是引用中的正文内容。
>
> ### 子标题
>
> 更多引用内容。
渲染效果:
引用中的标题
这是引用中的正文内容。
子标题
更多引用内容。
引用中的列表
markdown
> 引用中的列表:
>
> 1. 第一项
> 2. 第二项
> 3. 第三项
>
> 或者无序列表:
>
> - 项目 A
> - 项目 B
> - 项目 C
渲染效果:
引用中的列表:
- 第一项
- 第二项
- 第三项
或者无序列表:
- 项目 A
- 项目 B
- 项目 C
引用中的代码块
markdown
> 以下是代码示例:
>
> ```javascript
> function hello() {
> console.log("Hello, World!");
> }
> ```
>
> 代码块在引用中也能正常显示。
渲染效果:
以下是代码示例:
javascriptfunction 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. 按照向导完成安装
相关语法
练习
尝试创建以下内容:
- 一个包含多个段落的引用块
- 一个三级嵌套的引用结构
- 一个包含代码示例的技术说明引用
- 一个模拟对话的嵌套引用