Markdown 水平線：分隔線、規則與常見問題修復

要在 Markdown 中新增水平線，請將三個連字元單獨放在一行，並在上下各留一行空行：

第一節結束。

---

下一節開始。

結果是在兩個段落之間顯示一條分隔線。Markdown 將其稱為主題分隔符，HTML 用 <hr> 表示。將範例貼上到 Markdown 檢視器，即可檢查渲染後的文件。

三種分隔線寫法

以下寫法都會生成主題分隔符：

Markdown 原始碼	結果
---	水平分隔線
***	水平分隔線
___	水平分隔線
* * *	水平分隔線

至少使用三個相同的連字元、星號或底線。標記之間允許有空格。混用標記型別、在同一行新增文字或只使用兩個標記，都不會生成分隔線。這些規則來自 CommonMark 主題分隔符規範。

連字元的數量不會控制分隔線的顯示寬度。20 個連字元與三個連字元生成相同的 HTML 元素，最終外觀由目標平臺的樣式決定。

為什麼水平線變成了標題？

下面的原始碼不會在“更新說明”下方放置分隔線：

更新說明
---

它會生成二級標題。緊接在段落文字下方的連字元可以構成 Setext 標題，這種解釋優先於水平線。新增空行即可將兩者分開：

更新說明

---

對於文件章節，明確寫出標題通常更清晰：

## 更新說明

匯入流程現已支援 CSV 檔案。

使用 Markdown 標題標識章節。如果內容之間的轉折本身有意義，例如將信件與附錄分開，則可以使用水平線。

為什麼分隔線顯示成了普通文字？

檢查分隔線附近的原始碼：

現象	可能原因	修復方法
預覽在程式碼區塊中顯示 ---	獨立塊開頭有四個空格，或程式碼圍欄尚未關閉	移除縮排或關閉程式碼圍欄
預覽顯示 --	只有兩個連字元	使用三個或更多
標記旁邊出現文字	同一行包含其他文字	將標記單獨放在一行
句子中直接顯示 ---	標記被反引號包圍	需要分隔線時移除反引號
前一段變成了標題	--- 上方沒有空行	插入空行

在文件頂層，主題分隔符最多允許三個前導空格。在列表中，縮排還決定內容屬於哪個列表項，因此應檢查周圍的列表結構，而不是刪除所有空格。

水平線與換行不同

分隔線用於分開章節，並不只是把後面的文字移到下一行。

對於地址，請使用硬換行：

市場街 120 號\
加利福尼亞州舊金山

要新建段落，請留一行空行。要分隔章節，請將 --- 單獨放在一行。Markdown 換行指南解釋了尾部空格、反斜槓，以及 GitHub 檔案與評論中不同的換行行為。

在引用中放置分隔線

每一行都保留 > 字首，包括分隔線和空行：

> 原始提案。
>
> ---
>
> 審閱者補充的背景資訊。

這樣分隔線會留在引用內部。移除分隔線前的 > 可能結束引用，並把分隔線移到外層文件。有關多段落和巢狀引用，請參閱引用範例。

表格分隔行不是水平線

下面的分隔行屬於表格：

| 格式 | 可編輯 |
| --- | :---: |
| Markdown | 是 |

直線符號和可選的冒號描述的是列，不會插入橫跨頁面的分隔線。可使用 Markdown 表格生成器建立表格；如果資料已存在於電子表格中，可使用 CSV 轉 Markdown 轉換器。

水平線與匯出文件

主題分隔符不是分頁命令。PDF 或 Word 匯出工具根據佈局與分頁規則決定頁面在哪裡結束。不要新增更多連字元，並期待下一節因此從新的一頁開始。

如果你能控制網頁的 CSS，可以在網站樣式表中設定生成的 <hr> 的樣式。託管式 Markdown 服務可能不允許自訂 CSS。請檢查最終發布位置或匯出文件，尤其當分隔線所傳達的含義在列印後仍需保留時。

常見問題

水平線上下需要空行嗎？

CommonMark 並非在所有場景都要求空行，但保留空行可以避免 --- 被識別為標題的常見歧義，也讓原始檔更易讀。

可以使用 HTML 的 hr 標籤嗎？

允許原始 HTML 的渲染器支援 <hr>。對於 Markdown 文件，使用 --- 更合適。MD File Viewer 編輯器會移除使用者輸入的 HTML 標籤，但會正常渲染 Markdown 分隔線語法。

如何顯示三個連字元而不生成分隔線？

展示語法範例時，使用行內程式碼：`---`。要在獨立的一行顯示普通文字，請轉義第一個連字元：\---。

其他常用格式可以隨時查閱 Markdown 速查表。