返回部落格
教學
Markdown 換行
Markdown 新行
Markdown 新增一行
格式設定

Markdown 換行:新行、段落與表格儲存格

使用反斜線、兩個空格或空白行在 Markdown 中換行。匯出 Word 前,解決 README、清單和表格儲存格中的換行問題。

5 分鐘閱讀Markdown to Word 團隊

要在 Markdown 段落內另起一行,請在第一行結尾加上反斜線,然後按 Enter。要開始一個獨立段落,請留一個空白行。這兩種寫法會形成不同的文件結構,之後將 README、地址或報告匯出為 Word 時,這點很重要。

文件團隊\
範例街 42 號\
奧勒岡州波特蘭市

這個地址仍屬於同一段落,但顯示為三行。將它貼到 Markdown 預覽工具,與下方範例比較。

選擇需要的換行方式

預期效果Markdown 原始碼常見用途
延續同一段落一個普通換行將較長的原始碼行拆開
在同一段落內另起一行反斜線後按 Enter地址和短詩
開始一個新段落一個空白行分隔文章中的不同想法
在表格儲存格內換行在支援 HTML 的環境中使用 <br>在一個儲存格內放兩個簡短標籤

換行不會產生分頁。如果匯出文件的下一節需要從新的一頁開始,請參閱獨立的 Markdown 分頁指南

為什麼按 Enter 後看起來像一個空格

試試這段原始碼:

草稿已準備好。
審閱者今天就可以開啟它。

在本站的預覽中,兩句話屬於同一段落,會連續排版。原始碼檔案中的換行仍有助於閱讀,但不會強制瀏覽器另起一行顯示。瀏覽器仍會根據可用寬度自動折行。

現在插入一個空白行:

草稿已準備好。

審閱者今天就可以開啟它。

預覽會產生兩個段落。如果第二句話開始表達新想法,就使用這種寫法。加入多個空白行並不能可靠地增加垂直間距;段落樣式應由轉譯器或文件範本決定。

反斜線或兩個行尾空格

CommonMark 將換行字元前的兩個空格,以及換行字元前的反斜線,都定義為段落內的強制換行語法。CommonMark 強制換行範例記錄了這兩種形式。

使用反斜線時,審閱檔案的人可以直接看到換行標記:

由文件團隊撰寫\
由發行負責人審閱

另一種方法是在 撰寫 後正好輸入兩個空格,再按 Enter。許多編輯器不會顯示這些空格,而且自動清理行尾空白的功能可能會將它們刪除。如果儲存後換行消失,請檢查空白字元設定,或改用反斜線寫法。

不要在普通正文中輸入 \n 這兩個字元並期待換行。這是程式語言字串中的慣例,並不是 Markdown 的換行方式。也要避免在段落的最末尾加反斜線:強制換行之後必須還有同一段落的下一行內容。

GitHub 留言和 README 檔案的呈現方式不同

GitHub 的換行文件區分了儲存庫中的 .md 檔案,以及議題、提取要求和討論。在這些交流介面中,普通換行可能會直接顯示為換行,而 README 需要明確的強制換行語法。

這解釋了為什麼從議題中複製的文字放到 README 後,顯示效果可能不同。請檢查目標檔案,不要假定同一網站的所有介面都使用完全一致的格式規則。

將接續行保留在清單項目內

將接續行縮排到與該清單項目正文開頭對齊的位置:

- 發行說明\
  包含移轉指引。
- 安裝指南

這裡,第一個清單項目顯示為兩行,第二個項目仍然獨立。要在第一個清單項目內另起一個段落,請加入空白行,並讓後續內容繼續保持縮排:

- 發行說明

  包含移轉指引和已知問題。
- 安裝指南

縮排指南介紹了編號清單、巢狀項目符號清單,以及清單項目內的程式碼。

在 Markdown 表格儲存格內換行

GFM 表格的一列應寫在同一原始碼行上。在內容中按 Enter 可能會拆斷這一列。在允許 HTML 換行的轉譯器中,可採用以下寫法:

| 文件 | 負責人 |
| --- | --- |
| 發行說明 | 撰寫者<br>審閱者 |

本站預覽支援這個範例。會清除 HTML 的目標平台可能會刪除換行,或直接顯示標籤,因此在整份文件中採用這種寫法前,請先檢查該平台。當一個儲存格需要包含多個段落時,將內容寫成表格之外的清單通常更容易維護。

處理表格資料時,可使用 Markdown 表格產生器;了解對齊方式和直線字元跳脫時,可參閱表格語法指南

檢查匯出的文件

使用 Markdown 轉 Word 轉換器之前,先測試一個簡短範例,其中分別包含一個普通換行、一個明確的強制換行和一個空白行。預覽應依序顯示為連續排版的同一段落、強制換行,以及兩個獨立段落。

開啟下載的 DOCX,檢查地址、清單和表格。即使底層換行結構正確,頁面寬度和 Word 的段落樣式仍可能改變文字的折行位置。先修正 Markdown 結構;當特定文件範本有要求時,再在 Word 中調整最終排版。

相關文章