Word、Excel、PDF 表格要交給 AI？先用 kordoc 轉成 Markdown

同事傳來一份 Word 報名須知，裡面有張費用表。你想請 AI 幫你整理成重點，卻發現直接複製貼上，表格常常變成一行行散掉的字，合併的格子更是對不上。如果先把文件轉成 Markdown，表格結構就能原樣保留，AI 也讀得懂。

kordoc 是一個 Node.js 的命令列工具，能把 Word（docx）、Excel（xlsx）、PDF 轉成 Markdown。作者是韓國開發者，工具原本強項是韓國的 HWP 文件，我這次只測通用的 Office 與 PDF。

測試設備與版本

• 測試設備：Mac mini M4 Pro（12 核、64GB）
• 版本：kordoc 4.24.38（MIT 授權）、Node.js 22
• 測試檔案全是自製：一份 docx、一份 xlsx、一份英文 PDF

安裝

npm install kordoc

注意：官方說明把 PDF、OCR 列為選裝套件，可用 --omit=optional 省略。我實測這樣裝之後轉 PDF 會失敗：

MISSING_DEPENDENCY
PDF 파싱에 pdfjs-dist가 필요합니다

要轉 PDF 就得完整安裝，裝完 node_modules 約 509M。只轉 Word 與 Excel 的話，省略選裝套件即可。

轉換 Word

npx kordoc notice.docx -o notice.md

我的 docx 有標題、一段文字和一張 4 列 3 欄的表格，最後一列把兩格合併。轉換約 0.312 秒，結果：

# 活動報名須知

<table>
<tr><th>項目</th><th>費用</th><th>備註</th></tr>
...
<tr><td>合計</td><td colspan="2">依票種計算</td></tr>
</table>

遇到有合併儲存格的表格，kordoc 輸出的是 HTML 表格，用 colspan 保留合併資訊；沒有合併的表格（如下面的 Excel）則輸出一般的 Markdown 表格。

轉換 Excel

npx kordoc stock.xlsx -o stock.md

自製的 xlsx 有「一月」「二月」兩張工作表，轉出來是 ## 一月、## 二月 兩段，各自一張表格，耗時約 0.255 秒。

轉換 PDF

npx kordoc q3.pdf

我用一份有框線的英文 PDF 測試，三列三欄的表格轉出來還是 Markdown 表格（耗時約 0.369 秒）：

| item | qty | price |
| --- | --- | --- |
| mouse | 3 | 450 |
| keyboard | 2 | 1200 |

一次轉多個檔案

npx kordoc notice.docx stock.xlsx q3.pdf -d out3

多個檔案要用 -d 指定輸出資料夾，我實測三個檔案各自產生一個 .md。

常見問題

• PDF 轉換報 MISSING_DEPENDENCY：安裝時省略了選裝套件，重新執行 npm install kordoc（不加 --omit=optional）。
• 中文 PDF 能不能用：我自製中文 PDF 時字型沒有嵌入，轉出來是亂碼，那是測試檔的問題，不是工具的結果，所以中文 PDF 沒有結論。
• 掃描檔、HWP：官方說明有支援 OCR 與 HWP，本次沒測。

結論

適合常把 Word、Excel、PDF 交給 AI 整理、又在意表格不要跑掉的人，一行指令就能轉。不適合需要處理掃描檔或中文 PDF 又想先確認品質的人，這兩項我沒有驗證。我也沒有實際把輸出貼給 AI 比對效果，只確認轉出來的 Markdown 內容正確。

專案連結：https://github.com/chrisryugj/kordoc ，授權：MIT。

測試設備：Mac mini M4 Pro（12 核、64GB）。內容依實際執行結果撰寫，數據為撰寫當時的實測值。