Markdown 引用

1. 前言

Markdown 支持在文檔中定義引用效果。官方說明如下：

中文解釋：Markdown 使用郵件風格「大括號 >」的引用聲明。如果你已了解如何在郵件中引用文章，那代表你也掌握了在 Markdown 文本中引用文字的方法了。其實現方式就是在被引用的文字行開頭添加「大于號 >」。

原文出處：daringfireball.net。

引用寫法起源于電子郵件，在信件往來過程中，通過引用的形式，表現出郵件的關聯性。

環(huán)境說明：
考慮到 Markdown 工具之間的不兼容，有的內容直接從頁面復制粘貼到本地不會正常顯示，大家學習時自己動手寫是肯定沒問題的。本節(jié)所有實例代碼及演示效果均使用 Typora 工具完成。

2. 語法詳解

2.1 塊引用

在 Markdown 文件中，用「大于號」開頭的行會被轉換為塊引用。

實例 1：

這是一段普通的文本內容。

“一支穿云箭，千軍萬馬來相見；兩副忠義膽，刀山火海提命現。”  —— 星仔

其默認渲染效果如下

實例 2：

在行首加入「大于號 >」，將其改變?yōu)閴K引用。

> “一支穿云箭，千軍萬馬來相見；兩副忠義膽，刀山火海提命現?！? —— 星仔

其修改后渲染效果如下：

實例 3：

如果需要在塊引用內的換行，可以在行尾增加兩個連續(xù)的空格。

> 一支穿云箭，千軍萬馬來相見；  
> 兩副忠義膽，刀山火海提命現。  
> —— 星仔

其渲染效果如下：

實例 4：

這一寫法還可以簡化成只在第一行加入引用符號。

> 一支穿云箭，千軍萬馬來相見；  
兩副忠義膽，刀山火海提命現。  
—— 星仔

其渲染效果與以前一樣：

實例 5：

如果需要在塊引用里分段，只要在塊引用內增加由塊引用符號開啟的空行即可。

> 一支穿云箭，千軍萬馬來相見；
>
> 兩副忠義膽，刀山火海提命現。
>
> —— 星仔

其渲染結果如下：

塊引用會被渲染成 html 的 blockquote 標簽：

<blockquote>
<p>"一支穿云箭，千軍萬馬來相見；兩副忠義膽，刀山火海提命現。"  —— 星仔</p>
</blockquote>

2.2 塊引用的嵌套

Markdown 的塊引用是有嵌套層級概念的，即一個塊引用中，可以包含新一層的塊引用，類似于電子郵件的多次往復效果，又好像論壇留言的多次回復。塊引用的嵌套可以通過多個連續(xù) 「大于號 “>”」實現。

實例 6：

包含嵌套的塊引用。

### 塊引用的嵌套

塊引用的嵌套依賴于行首塊引用標志 ">" 的數量。

> 這是一個塊引用
>
> > 這是一個二層塊引用
>
> 返回到第一層

當然我們也可以直接使用多層塊引用

> > > > > > > 直接的七層塊引用

其渲染效果如下：

2.3 塊引用內容里的其他形式

Markdown 塊引用像段落一樣，里面的文字同樣支持類似于加粗、代碼塊、列表、表格等。

實例 7：

### 塊引用的特殊樣式

> #### 塊引用里的標題
>
> 塊引用里的 **重點文字**
>
> 塊引用里的列表
> - 項目1
> - 項目2
> - 項目3
>
> 塊引用里的表格
>
> |a|b|
> |---|---|
> |c|d|
>
> 塊引用里的分割線
> ___
>

渲染結果如下：

2.4 自定義塊引用的樣式

如果需要定制塊引用的樣式，可以通過 CSS 實現。

實例 8：

### 擴展塊引用的樣式

> 一支穿云箭，千軍萬馬來相見；  
> 兩副忠義膽，刀山火海提命現。  
> —— 星仔

<style>
blockquote {
  border-left: 2px dashed #333 !important;
  background: linear-gradient(to bottom, #efe 0%,#fef 100%) !important;
}
</style>

其渲染結果如下：

3. 使用場景及應用實例

塊引用的使用場景非常明確。比如在郵件中，我們使用塊引用的方式表示所回信件內容，因為回信行為是相互且多次的，所以塊引用也可以用于嵌套。那在文章中，我們可以將一個他人的觀點、原文、某個事件等信息增加塊引用效果，以增加我們文章的可靠感。

實例 9：

一篇典型的論壇評論。

### 一個典型的論壇評論

> [_BAT P99_]() 評論說:  
> 大多數從業(yè)者，水平太弱⊙﹏⊙  
> [同意?]()(1)  [舉報?]()(100)
>
> > [_匿名用戶_]() 評論說:   
> > 非誠勿擾相親節(jié)目中，被滅燈的男子采訪感言：我不知道為什么，說自己是做PHP，燈就全滅了。  
> > [同意?]()(1k+)  [舉報?]()(0)
> >
> > > [_PHP_]() 評論說：  
> > > PHP 是最好的語言！
> > >
> > > ![](./images/other.jpg)
> > >
> > > [同意?]()(1k+)  [舉報?]()(0)

其渲染結果如下：

4. 小結

1. 在塊引用中，同一引用范圍內的空行也是需要由塊引用標識引導的；
2. 在塊引用中，我們依然可以使用其他特殊樣式，比如粗體字、列表等。

在有討論、說明性質的文章中，塊引用通常放在文章的開頭，即從一開始拋出某個觀點，后面再用大篇幅去做詳細的解讀，塊引用有很好的聚焦功能，整篇文章中塊引用的占比盡量不要太多，否則會導致讀者的注意力不集中。