引用语法 #

概述 #

引用用于表示引用其他来源的内容,使用 > 符号创建。

基本语法 #

在文本前添加 > 符号:

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