文件交收
Markdown 轉 Word：網上方法、Pandoc 及 DOCX 檢查
作者 MDFormats · 約 5 分鐘 · 發布於
Markdown 轉 Word，需要將標題、清單和表格轉成真正的 DOCX 文件。單把 .md 改名為 .docx，並不會完成轉換。交給同事前，請開啟下載的檔案，確認文字及表格可以編輯，並保留 Markdown 原稿。
處理一份現成文件，可以直接用網上 Markdown 轉 Word。若要重複轉換多份文件，或沿用指定的 Word 樣式，則可考慮 Pandoc。以下用文件交收清單示範；使用 MDFormats 不需要安裝 Pandoc。
本頁目錄
按交付要求選擇 Markdown 轉 DOCX 方法
| 交付要求 | 可採用的方式 | 需要檢查 |
|---|---|---|
| 不安裝軟件，先轉換一份文件 | 瀏覽器轉換工具 | 下載後的標題、儲存格及連結 |
| 以相同步驟重複處理文件 | Pandoc 及自行管理的指令碼 | 輸入格式、選項及實際輸出 |
| 配合既定 Word 樣式 | Pandoc 及參考 DOCX | 標題樣式、字型與表格外觀 |
| 完成複雜版面 | 轉換結構後在 Word 整理 | 分頁、浮動圖片、合併儲存格、頁首 |
MDFormats 在瀏覽器內處理文件，但預覽引用的外部圖片仍可能向圖片網站發出請求。本機處理並不代表所有資源都離線。Pandoc 也可能存取文件參照的外部資源；涉及內部資料時，請一併檢查圖片與連結。
Word 文件的換行、字型和分頁會受收件人使用的應用程式及頁面設定影響。因此，預覽只適合初步檢查結構，不能代替開啟下載檔案。
先用一份交收清單核對結果
把以下內容以 UTF-8 儲存為 report.md，或貼上轉換工具。編號可協助檢查開頭的零及行列關係；連結只是示例，並非實際工作文件。
# 文件交收清單
發出前請核對 **確認版本**。
## 交收記錄
| 文件 | 編號 | 狀態 |
| --- | --- | --- |
| 操作說明 | DOC-0017 | 已核對 |
| 測試清單 | QA-0023 | 待補充 |
## 發出前的工作
- 保留 Markdown 原稿
- 開啟下載的 Word 檔案
只在相應項目執行 `npm run build`。
[示例文件](https://example.com/docs)
表格連同標題行應有三行三欄。npm run build 是檢查行內程式碼的示例文字，毋須實際執行。首次操作時保留檔名、編號及語法符號，較容易分辨原稿修改與轉換問題。
在瀏覽器轉換後開啟 DOCX 檢查
- 開啟 Markdown 轉 Word，貼上原稿或上載
report.md（檔案仍在瀏覽器內處理）。 - 在預覽核對兩層標題、表格和兩個清單項目。表格若只顯示直線符號，先修正原稿。
- 選擇 DOCX 下載操作，儲存檔案。
- 用 Word 或收件人實際使用的相容應用程式開啟。
- 點選
QA-0023的儲存格並修改文字，確認它不是表格截圖。
逐行對照編號、文件名稱和狀態，再檢查連結目的地。表格看似整齊，也可能有內容放錯行。處理寬表格時，可縮短重複標題或分拆內容，再在 Word 調整欄寬；Markdown 對齊符號不保證所有 DOCX 匯出方式都保留相同對齊。
Pandoc 是甚麼？甚麼情況才需要？
Pandoc 是開放原始碼的命令列文件轉換工具。安裝後，在終端機指定輸入檔案和輸出格式，便可執行轉換。它適合希望以指令碼重複工作的人，並非使用本站的必要軟件。
按官方安裝說明完成安裝後，先查版本，再用同一份原稿測試。
pandoc --version
pandoc report.md -f gfm -t docx -o report.docx
-f gfm 指定 GitHub Flavored Markdown，支援本例的直線分隔表格；-t docx 是輸出格式，-o 是輸出檔名。請在 report.md 所在資料夾執行，或提供正確路徑。遇到找不到檔案的訊息，應先核對路徑。
團隊若採用固定流程，請同時記錄版本及指令。升級工具或改用其他語法後，重新檢查代表性文件。
以參考 DOCX 沿用樣式
可先從示例產生一份起始 DOCX，在 Word 修改相關樣式並儲存，再於轉換時引用。
pandoc report.md -f gfm -t docx -o reference.docx
用 Word 開啟 reference.docx，修改所需樣式並儲存，再執行下一個指令。日後沿用樣式時，不要重新產生並覆寫已調整的參考檔案。
pandoc report.md -f gfm -t docx --reference-doc=reference.docx -o report-styled.docx
參考文件提供支援的樣式及文件屬性，不會把它的正文加進輸出，也不是自動插入封面的方式。詳情見官方參考文件說明。首次輸出仍要檢查標題、字型、表格寬度和分頁。
圖片、公式及複雜版面另外處理
MDFormats 目前的 DOCX 不會嵌入圖片。即使預覽顯示正常，仍需在 Word 加入所需圖片，並核對位置。原圖檔也應保留。
公式會以 Markdown 文字匯出，不會變成 Word 原生公式。如需可編輯公式，可在 Word 建立，或選擇已驗證支援該記法的流程。Pandoc 的支援範圍與本站不同，不能假設兩者的輸出物件完全一致。
合併儲存格、浮動圖片、頁首頁尾和精準分頁，都需要在最終使用的應用程式檢查。Markdown 結構並不等於完整的 Word 版面設定。
發出前檢查整份文件
從開頭、中段到結尾逐一核對。本例應有正確的標題層級、三行三欄、兩個編號、程式碼文字、連結和最後段落。嘗試編輯一個儲存格再儲存，確認符合收件人的工作需要。
同事交回修改後的 DOCX，可用 Word 轉 Markdown建立後續草稿。但往返轉換不保證保留所有排版，請與交回的文件對照，並保留兩份原件。
常見問題
Word 能直接開啟 MD 嗎？
讀取純文字與建立 Word 標題、表格是兩回事。如要結構化及可編輯的文件，應轉成 DOCX 後檢查。
網上轉換一定要裝 Pandoc 嗎？
不需要。MDFormats 在瀏覽器使用；Pandoc 是有命令列或參考樣式需要時的另一種做法。
DOCX 會與預覽一模一樣嗎？
不保證。應用程式、字型及頁面設定都影響換行。寬表格、圖片和公式尤其要在下載後確認。
匯出後要保留 Markdown 嗎？
建議保留，方便繼續修訂；DOCX 則供 Word 編輯。Markdown 轉 Word 的最後一步，是開啟儲存的文件驗收。