Markdown 換行:新行、段落與表格儲存格
使用反斜線、兩個空格或空白行在 Markdown 中換行。匯出 Word 前,解決 README、清單和表格儲存格中的換行問題。
要在 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 中調整最終排版。