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 整理創建