掌握 Markdown 區塊引言技巧：從基礎到進階應用

Markdown 中的區塊引言功能非常實用，可以讓文字結構更清晰、重點更突出。本指南將介紹不同層次的區塊引言使用方式，並展示如何將引言與其他 Markdown 元素結合，讓內容表達更加靈活、豐富。

• 區塊引言的基本用法
  • 基本範例
• 多段落區塊引言
  • 多段落區塊引言範例
• 巢狀區塊引言
  • 巢狀引言範例
• 在區塊引言中使用其他 Markdown 元素
  • 範例：區塊引言中包含標題、清單和程式碼區塊
• 進階技巧：更緊湊的多段落引言
  • 緊湊的多段落引言範例
• 提示和最佳實踐

---

區塊引言的基本用法

在 Markdown 中，使用 > 符號可將文字轉為區塊引言。 您只需在段落每行行首添加 >，即可讓該段落以引言形式顯示。

基本範例

> 這是一個簡單的區塊引言。

呈現效果：

這是一個簡單的區塊引言。

重點說明：

• 符號位置： > 符號必須放在每一行的最前面。
• 單行引言： 即使只有一行文字，也需要在行首加上 >。
• 與前段文字區隔： 建議區塊引言段落前後都留有空行，以確保 Markdown 語法解析器能正確識別引言區塊。

---

多段落區塊引言

如果您想建立包含多個段落的引言，則需要在每個段落的每一行行首都加上 >。 段落之間可以留空行，Markdown 會將它們視為同一個區塊引言的不同段落。

多段落區塊引言範例

> 這是一個包含兩個段落的區塊引言。
> 這是第一段的內容。
>
> > 這是第二段的內容，讓引言更加豐富。

呈現效果：

這是一個包含兩個段落的區塊引言。

這是第一段的內容。

這是第二段的內容，讓引言更加豐富。

重點說明：

• 每段落皆需標記： 多段落引言的重點在於，每個新段落的每一行 都必須以 > 開頭。
• 空行分隔段落： 引言區塊內，連續兩個 > 開頭的段落之間若有空行，則在呈現時會被視為段落分隔。 若要讓段落更緊密相連，可以移除段落間的空行。 (請參考下方的「進階技巧：更緊湊的多段落引言」)

---

巢狀區塊引言

Markdown 支援巢狀引言，只需增加 > 符號的數量來表示引言的層級。 巢狀引言常用於區分不同層次的引用來源，或在引言中再引用其他內容。

巢狀引言範例

> 這是第一層引言。
>
> > 這是第二層引言。
> >
> > > 這是第三層引言。
> >
> > 回到第二層引言。
>
> 回到第一層引言。

呈現效果：

這是第一層引言。

這是第二層引言。

這是第三層引言。

回到第二層引言。

回到第一層引言。

重點說明：

• 層級遞增： 每增加一個 > 符號，引言層級就加深一層。
• 視覺區分： 巢狀引言在視覺上會產生層次分明的效果，通常以縮排或不同的樣式來區分層級 (實際呈現效果依 Markdown 渲染器而定)。

---

在區塊引言中使用其他 Markdown 元素

區塊引言的功能非常強大，不僅能包含純文字，還可以靈活地與其他 Markdown 元素結合使用，例如：標題、清單、程式碼區塊、連結、圖片等等，讓引言內容更加豐富多元。

範例：區塊引言中包含標題、清單和程式碼區塊

> ## 這是一個引言中的標題
>
> 1. 這是清單項目一
> 2. 這是清單項目二
>
> 以下是一些程式碼範例：
>
>     return shell_exec("echo $input | $markdown_script");

呈現效果：

這是一個引言中的標題

1. 這是清單項目一
2. 這是清單項目二

以下是一些程式碼範例：

return shell_exec("echo $input | $markdown_script");

重點說明：

• 語法嵌套： 在 > 符號之後，可以自由使用其他 Markdown 語法。 例如，## 代表標題，1. 和 2. 代表有序清單，縮排四個空格或 Tab 代表程式碼區塊。
• 豐富引言內容： 透過元素嵌套，可以創建更複雜、資訊更豐富的引言，不僅僅是單純的文字引用。

---

進階技巧：更緊湊的多段落引言

在標準 Markdown 語法中，多段落區塊引言的每個段落之間會以空行分隔。 如果您希望讓多個段落的引言在視覺上更緊湊地連在一起，可以移除段落之間的空行。

緊湊的多段落引言範例

> 這是一個更緊湊的多段落區塊引言。
> 這是第一段的內容。
> > 這是第二段的內容，段落之間沒有空行。
> 這是第三段的內容，與第二段緊密相連。

呈現效果：

這是一個更緊湊的多段落區塊引言。

這是第一段的內容。

這是第二段的內容，段落之間沒有空行。

這是第三段的內容，與第二段緊密相連。

效果說明：

• 段落更緊密： 移除空行後，相鄰的引言段落會更緊密地排列在一起，視覺上更連貫。
• 適用於簡短引言： 這種技巧適用於段落較短、希望呈現更緊湊引言效果的場景。
• 注意巢狀層級： 在緊湊型多段落引言中，巢狀引言的層級關係仍然有效。 如範例中的第二段使用了兩層 > 符號，仍然會呈現巢狀引言效果。

---

提示和最佳實踐

• 段落前後空行： 為確保區塊引言的格式正確，強烈建議在引言段落前後都加上空行。 這有助於 Markdown 語法解析器正確識別引言區塊，避免格式混亂。
• 編輯器自動化： 善用文字編輯器的自動化功能。 某些文字編輯器 (例如 BBEdit) 支持自動化操作，例如選取文字後應用「增加引言階層」功能，以快速加入引言格式。 請查閱您使用的編輯器文件，了解是否有類似的自動化操作，以提升編輯效率。
• 一致的樣式： 在同一份 Markdown 文件中，保持區塊引言樣式的一致性，例如縮排、巢狀層級等，以維護文件的整體風格和專業度。

掌握以上技巧，您就能靈活應用 Markdown 區塊引言功能，讓文字內容更具層次感，更有效地在線上分享內容和清晰地表達觀點。 區塊引言是 Markdown 中非常實用的語法，善用它可以為您的文檔增色不少。