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

- 網址：https://blog.valenvan.uk/posts/chrisryugj-kordoc.html
- 發布日期：2026-11-03
- 測試設備：Mac mini M4 Pro（12 核、64GB）
- 專案：chrisryugj/kordoc（https://github.com/chrisryugj/kordoc），MIT 授權
- 測試版本：4.24.38
- 實測影片：https://www.youtube.com/watch?v=RVCCKp2tE8o

## 重點摘要

- kordoc 4.24.38 把自製 Word 表格轉成 Markdown 約 0.312 秒，合併儲存格以 colspan 保留。
- 自製 Excel 有兩張工作表，轉出來是兩段、各一張表格，約 0.255 秒。
- 有框線的英文 PDF 表格轉出來仍是三列三欄的 Markdown 表格，約 0.369 秒。
- 安裝時加 --omit=optional 會讓 PDF 轉換回報 MISSING_DEPENDENCY，完整安裝後 node_modules 約 509M。
- **結論：** 常把文件交給 AI 的人，一行指令就能把 Word、Excel、PDF 轉成保留表格的 Markdown；本次只測自製檔案。
- **適合：** 常把 Word、Excel、PDF 交給 AI 整理、在意表格格式的人
- **不適合：** 需要處理掃描檔、中文 PDF 或 HWP 且要先確認品質的人（本次未測）

| 實測項目 | 結果 |
|---|---|
| Word 轉換 | 0.312 秒，合併格保留為 colspan=2 |
| Excel 轉換 | 0.255 秒，2 張工作表分 2 段 |
| PDF 轉換 | 0.369 秒，3 列表格保留 |
| 批次轉換 | 3 個檔案輸出 3 個 .md |
| 省略選裝套件 | PDF 轉換失敗 MISSING_DEPENDENCY |
| 完整安裝大小 | node_modules 約 509M |

同事傳來一份 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

## 安裝

```bash
npm install kordoc
```

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

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

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

## 轉換 Word

```bash
npx kordoc notice.docx -o notice.md
```

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

```text
# 活動報名須知

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

![Word 轉換結果](https://blog.valenvan.uk/img/chrisryugj-kordoc-article_1.png)

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

## 轉換 Excel

```bash
npx kordoc stock.xlsx -o stock.md
```

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

![Excel 轉換結果](https://blog.valenvan.uk/img/chrisryugj-kordoc-article_2.png)

## 轉換 PDF

```bash
npx kordoc q3.pdf
```

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

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

## 一次轉多個檔案

```bash
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。