~/教學/ANYDOC.md

文章 / AI 工具

AnyDoc:PPT、Excel、Word 一行指令變成 Markdown,Claude Code 終於讀得懂(實測三份檔案)

Firecrawl 開源的 AnyDoc 把 Word、PPT、Excel、PDF、EPUB 轉成乾淨的 Markdown。一行 npx、裝成 Claude Code 技能、轉出來長什麼樣,還有掃描 PDF 的 OCR 限制。

丟一份 PPT 或 Excel 給 Claude Code,它沒辦法直接讀,得先另外寫程式拆檔。Firecrawl 開源的 AnyDoc 一行指令,就把 Word、PPT、Excel、PDF、EPUB 變成乾淨的 Markdown,表格、圖表數字和講者備註都留著。這篇是 Reels 裡 ANYDOC 那支影片的完整版:我拿三份檔案實際轉過,從為什麼要轉、怎麼轉、轉出來長什麼樣,到裝成技能讓 Claude Code 自己轉,還有掃描 PDF 的限制。

01先看結果:同一份簡報,變成 Claude 一眼讀懂的 Markdown

Reels 畫面:紙做的瀏覽器裡,左邊是小島咖啡第三季營運報告的投影片,右邊是轉出來的 Markdown,Markdown 慢慢蓋過整個畫面,蓋著「乾淨 Markdown」
Reels 畫面:左邊是真的投影片,右邊是 AnyDoc 從同一個 .pptx 轉出來的 Markdown。
投影片:小島咖啡 2026 第三季營運報告,一張有合併表頭的營收表格
轉檔前:我們做的示範簡報第 1 頁(小島咖啡是虛構的)。
編輯器畫面:同一張表格變成 Markdown 表格,下面的講者備註變成引用
轉檔後:AnyDoc 轉出的 .md,表格和講者備註都在。

照著做完,你會有:

  1. 一份 .md 檔:標題、表格、條列、講者備註都照原本的結構排好。
  2. 一個 Claude Code 技能:之後遇到 Word、PPT、Excel,它會自己先轉再讀。
  3. 一個判斷:哪些檔案能在本機轉,哪些(掃描的 PDF)會上傳到雲端。

02為什麼 Claude Code 讀不了 PPT 和 Excel

Reels 畫面:長桌上一個 .pptx 方塊被壓扁,彈出幾十個小方塊排成好幾排,牆上螢幕是 slide1.xml 密密麻麻的標籤
一份簡報拆開來:我們這份 .pptx 裡面有 50 個檔案。

Claude Code 讀檔案的工具會拒絕它當成二進位的檔案,例如 .xlsx,這時它只能另外寫程式或找技能來拆。原因是 .pptx、.docx、.xlsx 其實是壓縮檔,開啟來是一堆 XML。

  1. 我們這份只有兩頁的簡報,拆開來有 50 個檔案。
  2. 光是第 1 頁的 slide1.xml,就有 7,308 個字元,大部分是排版標籤。
  3. 整份簡報轉成 Markdown 之後,只剩 969 bytes。

03第 1 步:一行指令轉檔

Reels 畫面:筆電上的終端機,執行 npx @firecrawl/anydoc 小島咖啡Q3營運報告.pptx 之後印出的 Markdown
真實畫面:我在這臺電腦跑的那一次。

電腦有 Node.js 就能直接用,第一次執行會自動下載對應你電腦的版本:

在終端機執行(把[]換成你的檔名)
npx @firecrawl/anydoc [報告.pptx] -o [報告.md]

常用的話,裝成固定指令:

或者裝起來
npm install -g @firecrawl/anydoc
anydoc [報告.docx] -o [報告.md]
用 Python 的話
pip install firecrawl-anydoc

04第 2 步:看看轉出來長什麼樣

我們三份檔案實際轉出來的樣子:

  1. 簡報的表格變成 Markdown 表格;合併的表頭變成一格空白,數字都對。
  2. 長條圖的數字變成一張表格,Claude 讀得到 7、8、9 月的數字。
  3. 講者備註變成「>」開頭的引用,跟在那一頁後面。
  4. 條列保留了層級;Excel 的公式總計(377、354、731)也有出來。
  5. Word 合約的標題、表格和 1. 2. 3. 編號都照原本排好。

05第 3 步:裝成技能,讓 Claude Code 自己轉

Reels 畫面:牆上螢幕是 AnyDoc README 的 Agent skill 段落,npx skills add firecrawl/anydoc 被紅框圈起來
官方 README:AnyDoc 也是一個 Agent Skill,支援 Claude Code。

不想每次自己轉,就把它裝成技能。在專案的終端機執行:

在終端機執行
npx skills add firecrawl/anydoc

之後直接把檔案丟給 Claude Code:

跟 Claude Code 說(把[]換成你的)
幫我讀[報告.pptx],整理成三個重點,再把表格裡的數字做成一張比較表。

06要注意

Reels 畫面:紙做的瀏覽器裡是 AnyDoc README 的 OCR 段落,下面寫著 --ocr hosted,蓋著「整份上傳雲端」
官方 README:掃描的 PDF 要開 OCR,才會送到 Firecrawl 的雲端。
  1. 掃描或純圖片的 PDF 它讀不到(會直接停下來)。加 --ocr hosted 才會送到 Firecrawl Parse 做 OCR,而且是整份檔案上傳;不用註冊,設 FIRECRAWL_API_KEY 額度比較高。機密檔案先想清楚。
  2. 不想裝任何東西:官方的瀏覽器版 firecrawl.github.io/anydoc 在你的電腦上轉,檔案不會上傳。
  3. 圖片只會留下替代文字,圖片本身不會放進 Markdown。
  4. README 裡和其他工具的比較分數是 Firecrawl 自己測的,參考就好。
  5. AnyDoc 是 MIT 授權的開源專案,不是 Anthropic 官方出的。
  6. 這篇是在主頁連結輸入關鍵字 ANYDOC 找到的,不會私訊。

資料來源

延伸閱讀