← 回免費資源庫
AI 工具教學

PDF 別直接丟給 Claude:MarkItDown 安裝與使用教學

文字為主的 PDF,先用微軟的免費工具 MarkItDown 轉成文字再丟給 Claude,同一份檔案吃的 token 少很多。怎麼裝、怎麼用、哪些檔案別轉,都整理在下面囉!

直接把 PDF 上傳到 Claude,每一頁都會先轉成圖片、再把文字抽出來,圖片和文字各算一份,消耗的 token 自然比較多。如果是報告、合約這種以文字為主的檔案,即使用不到圖片裡的資訊,圖片那份也一樣要算 token。MarkItDown 是微軟推出的免費開源工具,可以把 PDF、Word、PowerPoint、Excel,甚至 YouTube 影片的字幕,轉成 AI 天生就看得懂的 Markdown(.md)文字。

直接丟 PDF,為什麼這麼吃 token

Claude 讀 100 頁以內的 PDF 時,會把每一頁先轉成一張圖片,再把頁面上的文字抽出來,圖片和文字一起讀。同一頁,等於算了兩份。

每一頁 PDF

大概多少 token
1,500 到 3,000,看內容多寡;圖片另外算
依據
Claude 官方文件

一份 33 頁的 PDF

大概多少 token
照上限算約 99,000(33 × 3,000,還沒算圖片)
依據
用官方的每頁上限算

同一份 3 頁的 PDF

大概多少 token
連圖一起讀約 7,000,只讀文字約 1,000
依據
Claude 官方文件的例子

token 吃得多,額度就用得快。Claude 官方說明也把「附件檔案大小」列為影響用量額度的因素之一,額度用完就只能等重置。

所以文字為主的檔案,先轉成文字再交給 Claude,它只需要讀文字那一份。照官方的例子算,token 用量能省下七成以上。

哪些檔案適合轉

文字為主的 PDF,例如報告、合約、會議記錄

要不要轉
轉
原因
圖片那份用不太到,轉了最省

PowerPoint 簡報檔

要不要轉
轉
原因
Claude 官方的上傳支援清單裡沒有 PowerPoint,轉成文字就能交給它

Word、Excel

要不要轉
轉不轉都可以
原因
Claude 讀這兩種檔案本來就只讀文字,不會多算圖片;Excel 要先在 Claude 設定裡打開「程式碼執行與檔案建立」才能上傳

圖表多的簡報、設計稿 PDF

要不要轉
別轉
原因
實測一份 28 頁的簡報 PDF,不到一秒就轉完,但圖表裡的資訊全部都不會留下來

掃描的 PDF(整頁都是圖片)

要不要轉
別轉
原因
實測轉出來是一片空白,MarkItDown 預設不會辨識圖片裡的字

超過 100 頁的 PDF

要不要轉
轉不轉差不多
原因
Claude 遇到 101 到 1,000 頁的 PDF,本來就只讀文字

YouTube 影片

要不要轉
可以轉
原因
轉出來的是影片資訊和字幕逐字稿,畫面不會轉

表格裡 Claude 的上傳限制,是 2026 年 10 月的官方說明。

先看你用哪一種 Claude

有付費方案(Pro、Max 等),願意裝 Claude 桌面版

怎麼做
讓 Claude Code 幫你裝 MarkItDown,之後轉檔也交給它
要裝什麼
Claude 桌面版

只用網頁版,或是免費方案

怎麼做
文字為主的 PDF 直接複製貼上;想自動轉,再自己用終端機裝 MarkItDown
要裝什麼
複製貼上什麼都不用裝;自動轉要裝 MarkItDown

會這樣分,是因為 Claude Code 只有付費方案才有,免費方案沒有。而且網頁版的 Claude Code 跑在 Anthropic 的雲端電腦上,碰不到你自己的電腦,沒辦法幫你把 MarkItDown 裝在電腦裡。要讓 Claude 幫你裝,最簡單的是用 Claude 桌面版。以上是 2026 年 10 月的官方說明。

有付費方案:讓 Claude Code 幫你裝、幫你轉

第一步:打開 Claude 桌面版的 Code 分頁

打開 Claude 桌面版,切到 Code 分頁。如果它請你選一個資料夾,選平常放 PDF 的資料夾最方便。

第二步:貼上這段話,讓它幫你安裝

提示詞
請幫我在這台電腦安裝微軟的免費工具 MarkItDown(https://github.com/microsoft/markitdown)。
1. 用不會弄亂系統 Python 的方式安裝(例如 uv 或 pipx)。
2. 要裝完整版,能轉 PDF、Word、PowerPoint、Excel 和 YouTube 連結。
3. 裝好之後,我在任何資料夾都能直接用 markitdown 指令。
4. 最後拿一個 PDF 實際轉一次,給我看結果。

過程中它可能會問你「可不可以執行這個指令」,看到是安裝 MarkItDown 相關的就按允許。整個過程大約幾分鐘,下載那段跑比較久。安裝只要做這一次。

第三步:設定一次,之後直接說要處理哪個檔案

把下面這段貼給 Claude Code,它會把規則寫進你的全域設定檔。這個檔案每次開新對話都會自動讀進去,所以只要設定一次。

提示詞
請把下面這條規則加進我的全域 CLAUDE.md(~/.claude/CLAUDE.md),以後每個對話都照做:
我請你讀 PDF 時,一律先用 markitdown 轉成同名的 .txt,只讀 .txt,不要直接打開 PDF。只有兩種情況改讀 PDF:轉出來幾乎沒有文字(通常是掃描檔),或我說這份要看圖表。

設定好之後,只要說「幫我整理下載資料夾裡的報告.pdf」,它就會先轉成文字再讀;遇到掃描檔,它會自己改讀 PDF。當然,如果哪天想讓它連圖片一起看,跟它說一聲「這份直接讀 PDF」就好。

這條規則只在 Claude Code 裡有效,也就是桌面版的 Code 分頁(終端機版的 Claude Code 也一樣)。一般的 Claude 聊天,不管是網頁版還是桌面版的對話,都不會讀這個設定檔,也沒辦法在你的電腦上執行 MarkItDown;在聊天裡,請用下面「只用網頁版」的方法。

官方說明也提醒,這類設定對 Claude 來說是參考,不是強制規則,偶爾沒照做的話,提醒它一句就好。轉好的 .txt 會跟 PDF 放在一起,也可以拿到 Claude 網頁版用,做法見下一段「用終端機轉檔」的第三步。

只用網頁版:不裝也能省

最簡單:直接複製貼上

文字為主的 PDF,打開之後全選、複製,直接貼進 Claude 的對話框。Claude 只會讀到文字,省掉的就是圖片那一份,原理跟 MarkItDown 一樣。

缺點是標題、表格的格式常會跑掉,頁數一多,手動複製也比較麻煩。常常要處理這類檔案的話,可以用下面的方法自己裝 MarkItDown。

想自動轉:自己用終端機裝 MarkItDown

先裝一個叫 uv 的小工具(專門幫你安裝這類程式),再用它裝 MarkItDown。安裝只要做這一次。

Mac:

第一步:打開「終端機」(按 Command+空白鍵,搜尋「終端機」)。

第二步:貼上下面這行,按 Enter,安裝 uv。

指令
curl -LsSf https://astral.sh/uv/install.sh | sh

第三步:跑完之後,把終端機整個關掉、重新打開,再貼上這行,按 Enter,安裝 MarkItDown。這一步要跑一兩分鐘,畫面會刷出一大串英文套件名稱,是正常的。

指令
uv tool install 'markitdown[all]'

Windows:

第一步:從開始選單搜尋「PowerShell」,打開它。

第二步:貼上下面這行,按 Enter,安裝 uv。

指令
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

第三步:跑完之後,把 PowerShell 關掉、重新打開,再貼上這行,按 Enter,安裝 MarkItDown。

指令
uv tool install "markitdown[all]"

裝好之後輸入 markitdown --version,有跳出版本號就代表成功了。如果出現 command not found(找不到指令),輸入 uv tool update-shell,再把終端機關掉重開一次。

用終端機轉檔

第一步:在終端機輸入 cd 和一個空格,再把放 PDF 的資料夾拖進終端機視窗,按 Enter。這樣接下來的指令,都會在那個資料夾裡執行。

第二步:輸入下面這行,把兩個「報告」換成你的檔名。檔名前後的引號要留著,檔名有空格才不會出錯。轉好的 .txt 會出現在同一個資料夾。

指令
markitdown "報告.pdf" -o "報告.txt"

YouTube 影片就把網址放進去:

指令
markitdown "https://www.youtube.com/watch?v=影片代碼" -o "影片.txt"

第三步:打開 .txt,全選複製,貼進 Claude 的對話框;也可以直接把 .txt 檔上傳給 Claude,Claude 支援上傳 .txt。

用 ChatGPT 的人,沒有這個問題

OpenAI 官方說明寫,ChatGPT 除了企業版(Enterprise),其他方案上傳 PDF 都只抽文字、不讀檔案裡的圖片,所以不會像 Claude 那樣一頁算兩份。

反過來說,PDF 裡的圖表,一般方案的 ChatGPT 是看不到的。需要它看圖,就把那一頁截圖,當成圖片另外上傳。以上是 2026 年 10 月的官方說明。

同一份文件要反覆問

把文件放進 Claude 的「專案(Projects)」裡。官方說明寫,專案裡的內容重複使用時會被快取,比較不吃額度。

資料來源