用 Markdown 寫作很舒服。麻煩在於，對方要求你交出 Word 檔案的時候。
公司內部的申請單、學術研討會的摘要、交給客戶的成果。對方不懂 Markdown，也沒有必要懂。本文介紹在 Mac 上把 Markdown 轉換成 Word（.docx）的 3 種方法，以及各自適合與不適合的人。
方法 1：Pandoc（免費，命令列）
Pandoc 是一款在各種文件格式之間互相轉換的開源工具。如果已經裝好 Homebrew，安裝只要一行指令。
brew install pandoc轉換也只要一行。
pandoc 稿件.md -o 稿件.docx標題、表格、清單和程式碼區塊都會直接轉換成 Word 的樣式。如果要符合公司的格式規範，可以準備一個 .docx 範本，讓 Pandoc 參照它。
pandoc 稿件.md --reference-doc=範本.docx -o 稿件.docx- 適合的人：習慣使用終端機、需要反覆進行相同轉換的人；想把轉換寫進腳本的人
- 需要注意的地方：Mermaid 等圖表無法直接變成圖片（需要搭配其他工具）。為了設定中文字型、調整目錄，最後可能還是得花不少時間製作範本
方法 2：線上轉換服務
有很多服務，只要把檔案拖進瀏覽器就能完成轉換。論方便，沒有比這更省事的了。
不過請留意，你的稿件會被上傳到別人的伺服器。尚未發表的論文、含有客戶資訊的會議紀錄、公司內部機密的規格書，都不該透過這類服務轉換。有些公司的規章也明文禁止這麼做。
- 適合的人：只是偶爾轉換準備公開發表的文章的人
- 不適合的人：需要處理機密文件的人
方法 3：使用具備輸出功能的編輯器
如果你用來寫作的 App 本身就能輸出 .docx，步驟最少。不必安裝轉換工具，也不必上傳檔案。
我們開發的 Markdocx 正是依照這個想法打造的 Mac Markdown 編輯器。
- App 本身就能輸出 Word（.docx）和 EPUB。不必安裝或設定 Pandoc，也不用命令列。還支援輸出為 PDF、HTML 和 Markdown
- 內建 Mermaid 圖表。可從工具列插入流程圖、循序圖、甘特圖等 10 種圖表，繪製完全在 Mac 上完成，不需要網路連線，也不使用外部服務
- 即時預覽。可左右或上下並排顯示，雙向捲動同步讓兩邊始終停在同一段落
- GitHub Flavored Markdown。支援表格、任務清單、刪除線以及帶有語法高亮的程式碼區塊
- 檔案始終是純 .md 格式。也能和其他編輯器搭配使用
書寫、即時預覽、Mermaid 圖表和大綱都能不限期免費使用。前 14 天可以試用所有功能，之後只要一次性購買 Markdocx Premium，就能解鎖 Word 輸入以及輸出為各種格式的功能。不是訂閱制，同一 Apple 帳號下的所有 Mac 都能使用。需要 macOS 26 或以上版本。
該選哪一種
| 方便程度 | 保密性 | 圖表（Mermaid） | 費用 | |
|---|---|---|---|---|
| Pandoc | △（命令列） | ◎（本機） | △（需另外搭配工具） | 免費 |
| 線上轉換 | ◎ | ✕（傳送到外部） | △ | 大多免費 |
| 具備輸出功能的編輯器 | ◎ | ◎（本機） | ◎ | 一次性購買 |
簡單來說：要把重複的轉換自動化，就選 Pandoc；想在一個 App 裡完成從日常寫作到交件的所有流程，就選具備輸出功能的編輯器。
轉換時容易遇到的問題
- 圖片的相對路徑：像
這樣的相對路徑，如果轉換時找不到圖片，圖片就會遺失。請不要改變稿件與圖片之間的相對位置 - 表格欄寬：Markdown 的表格沒有欄寬的概念，只能在 Word 裡調整
- 標題層級：事先決定好要用
#（H1）當作內文中的標題，還是另外設定文件標題，目錄就能產生得很整齊 - 換行的處理：依照 Markdown 的標準，單一換行不會被當作換行。寫中文稿件時，選用可以切換這項行為的編輯器會更省事