引用語法
引用(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. 按照向導完成安裝
相關語法
練習
嘗試創建以下內容:
- 一個包含多個段落的引用塊
- 一個三級嵌套的引用結構
- 一個包含代碼示例的技術說明引用
- 一個模擬對話的嵌套引用