引用语法 #
概述 #
引用用于表示引用其他来源的内容,使用 > 符号创建。
基本语法 #
在文本前添加 > 符号:
markdown
> 这是一段引用文字。
渲染效果:
这是一段引用文字。
多行引用 #
方式一:每行都加 > #
markdown
> 第一行引用
> 第二行引用
> 第三行引用
渲染效果:
第一行引用 第二行引用 第三行引用
方式二:只在首行加 > #
markdown
> 这是一个很长的引用,
可以跨越多行,
只要保持连续即可。
嵌套引用 #
使用多个 > 创建嵌套引用:
markdown
> 一级引用
>
> > 二级引用
> >
> > > 三级引用
渲染效果:
一级引用
二级引用
三级引用
引用中的其他元素 #
引用中包含标题 #
markdown
> ## 引用中的标题
>
> 这是引用内容。
引用中包含列表 #
markdown
> 引用中的列表:
>
> - 项目一
> - 项目二
> - 项目三
渲染效果:
引用中的列表:
- 项目一
- 项目二
- 项目三
引用中包含代码块 #
markdown
> 引用中的代码:
>
> ```javascript
> const x = 1;
> ```
引用中包含强调 #
markdown
> 这是一段**重要**的引用,其中包含*强调*内容。
渲染效果:
这是一段重要的引用,其中包含强调内容。
引用来源标注 #
标准格式 #
markdown
> 引用的内容。
>
> —— 作者名
渲染效果:
引用的内容。
—— 作者名
使用链接 #
markdown
> 简单、高效、优雅。
>
> —— [Markdown 设计理念](https://daringfireball.net/projects/markdown/)
使用 cite 标签 #
markdown
> 这是一段引用。
<cite>—— 作者名</cite>
实际应用 #
名言引用 #
markdown
> 生活不止眼前的代码,还有诗和远方。
>
> —— 程序员名言
文档提示 #
markdown
> **注意**:此功能在 v2.0 版本中已弃用,请使用新的 API。
渲染效果:
注意:此功能在 v2.0 版本中已弃用,请使用新的 API。
警告信息 #
markdown
> **警告**:此操作不可逆,请谨慎操作!
提示信息 #
markdown
> **提示**:使用 `npm install` 安装依赖。
文档说明 #
markdown
## 快速开始
> 本教程假设你已经安装了 Node.js 16+ 版本。
### 安装
运行以下命令...
引用样式 #
GitHub 风格 #
GitHub 上的引用通常带有左侧边框和背景色。
自定义样式 #
使用 HTML 自定义:
markdown
<blockquote style="border-left: 4px solid #42b983; padding-left: 16px; color: #666;">
自定义样式的引用
</blockquote>
彩色引用 #
markdown
<blockquote style="border-left: 4px solid #f66; background: #fff0f0; padding: 16px;">
<span style="color: #f66;">⚠️ 警告</span>
<br>
这是一个警告提示。
</blockquote>
引用 vs 其他元素 #
引用 vs 代码块 #
| 用途 | 使用 |
|---|---|
| 引用文字 | 引用 |
| 展示代码 | 代码块 |
引用 vs 强调 #
| 用途 | 使用 |
|---|---|
| 引用来源 | 引用 |
| 突出文字 | 强调 |
常见问题 #
问题1:引用不连续 #
markdown
> 第一段
> 第二段 ← 会变成两个独立的引用块
问题2:引用中的空行 #
markdown
> 第一段
>
> 第二段 ← 使用 > 加空行保持引用连续
问题3:引用符号后无空格 #
markdown
>正确 ← 可以工作
> 正确 ← 推荐:有空格更清晰
最佳实践 #
1. 引用后添加空行 #
markdown
> 这是引用内容。
这是正文内容。
2. 标注引用来源 #
markdown
> 引用内容
>
> —— 来源
3. 合理使用嵌套 #
markdown
> 不推荐过深的嵌套引用
>
> > 二级还可以
> >
> > > 三级就有点多了
4. 引用作为提示框 #
markdown
> **提示**:这是一个有用的提示。
> **注意**:需要注意的事项。
> **警告**:需要警告的内容。
引用类型总结 #
| 类型 | 用途 |
|---|---|
| 简单引用 | 引用文字 |
| 嵌套引用 | 引用中的引用 |
| 带来源引用 | 标注出处 |
| 提示引用 | 文档提示 |
| 警告引用 | 警告信息 |
下一步 #
继续学习 表格语法!
最后更新:2026-03-24