tutorial tables markdown docx

DOCX 到 Markdown 與表格:完整指南

如何將帶有表格的 Word 文件轉換為 Markdown GFM 表格格式。保留表格結構和處理複雜佈局的技巧。

W
WordToMD 團隊
·

表格是將 Word 文件轉換為 Markdown 時最棘手的元素之一。本指南向您準確展示表格轉換的工作原理以及如何獲得最佳結果。

Word 表格如何變成 Markdown 表格

Markdown(特別是 GitHub Flavored Markdown 或 GFM)支援使用管道字元的表格:

| Header 1 | Header 2 | Header 3 |
|----------|----------|----------|
| Cell 1   | Cell 2   | Cell 3   |
| Cell 4   | Cell 5   | Cell 6   |

轉換 Word 文件時,表格的第一行(如果樣式為標題行)將成為 GFM 表格標題,其下方有一條虛線分隔線。

轉換良好的表結構

簡單資料表 可以完美轉換:

特點支援註釋
標題行✓第一行對映到 首先 --- separator
多列✓多達 20 多個列
數字和文本✓混合單元格內容有效
單元格中的連結✓保留超連結

已知限制

合併單元格 — 當 Word 單元格跨越多列或多行 (colspan/rowspan) 時,沒有 Markdown 等效項。轉換器將輸出沒有跨越的單元格內容,這可能會導致列未對齊。

巢狀表 — 表內的表被展平為其文本內容。

複雜格式 — 保留表格單元格內的粗體、斜體和內聯程式碼,但可以簡化複雜的嵌入內容。

針對桌面文件的提示

  1. 避免合併單元格 如果可能的話——在轉換之前將它們分開
  2. 使用標題行樣式 — 右鍵單擊第一行並將其標記為標題行以獲得最佳結果
  3. 保持列計數一致 — 對於有效的 GFM 表,每行必須具有相同數量的單元格
  4. 轉換後稽核 — 在釋出之前始終在 Markdown 預覽中檢查表格輸出

渲染 Markdown 表

一旦你有了 Markdown 表格,它就會在以下位置正確呈現:

  • GitHub(自述檔案、問題、PR)
  • GitLab
  • Notion
  • Obsidian
  • 大多數靜態站點生成器(Jekyll、Hugo、Astro)
  • VS Code Markdown 預覽

嘗試一下 WordToMD 的免費轉換器 — 只需拖放您的 .docx 檔案,您的表格就會立即呈現為乾淨的 GFM Markdown。