文件交付
Markdown 轉 Word：線上方法、Pandoc 與 DOCX 驗收
作者 MDFormats · 約 4 分鐘 · 發布於
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 只是檢查行內程式碼的文字，不需要真的執行。第一次操作時，保留編號、檔名與 Markdown 符號，才容易判斷哪些變化來自轉換。
在瀏覽器匯出並開啟 DOCX
- 開啟 Markdown 轉 Word，貼上原文或匯入
report.md。 - 檢查兩層標題、表格與兩個獨立清單項目。若表格仍顯示直線符號，先修正來源。
- 使用 DOCX 下載操作，將檔案存到電腦。
- 用 Word 或收件人使用的應用程式開啟。
- 點選
QA-0023的儲存格並編輯文字，確認不是表格圖片。
逐列比對編號和狀態，再測試連結。外觀整齊不表示內容一定對應正確。寬表格可縮短重複標題、拆成多個表格，或在 Word 中調整欄寬；Markdown 的對齊記號不保證每個匯出器都呈現相同效果。
Pandoc 是什麼？需要安裝嗎？
Pandoc 是開放原始碼的命令列文件轉換程式。安裝後，以指令指定輸入與輸出，適合編寫可重複執行的工作流程。它是另一種工具，並非 MDFormats 的必要元件。
完成官方安裝步驟後，可檢查版本並轉換同一份文件：
pandoc --version
pandoc report.md -f gfm -t docx -o report.docx
-f gfm 選用支援本例表格的 GitHub Flavored Markdown；-t docx 是輸出格式，-o 是輸出檔名。請在 report.md 所在資料夾執行，或提供正確路徑。若找不到檔案，先檢查資料夾與檔名，而非反覆執行。
把版本和指令記錄在作業說明中。更換工具版本或來源語法後，重新檢查代表性文件。
用參考 DOCX 維護 Word 樣式
先從範例產生一份起始 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 版面配置。
交付前核對整份檔案
依序檢查開頭、中段與結尾。本例需核對標題層級、三列三欄、兩個編號、程式碼文字、連結與最後一段。嘗試修改儲存格並儲存，確認符合對方的編輯需求。
收到修改後的 Word 文件，可用 Word 轉 Markdown建立後續草稿，但往返轉換不保證保留所有排版。請與回傳檔案比對，兩份原稿都要留下。
常見問題
Word 能直接開啟 MD 嗎？
讀取純文字和建立 Word 標題、清單、表格是不同的事。需要結構化文件時，請轉成 DOCX 並確認內容。
線上轉換也要裝 Pandoc 嗎？
不用。MDFormats 在瀏覽器中使用；Pandoc 是命令列與參考樣式需求的另一種選擇。
DOCX 會與預覽完全相同嗎？
不保證。字型、應用程式與頁面設定會影響換行，寬表格、圖片與公式尤其需要檢查。
匯出之後還需要 MD 嗎？
建議保留。Markdown 用於修訂，DOCX 供 Word 編輯。Markdown 轉 Word 完成後，應再開啟儲存的檔案驗收。