您可以透過上傳 PDF 至服務、將其文字貼到聊天中,或請您的代理程式呼叫本機的轉換引擎,將 PDF 轉換為適合 LLM 使用的 Markdown。第三種方式會保留標題、表格與清單為真正的 Markdown,且不會上傳任何檔案。使用 GroupDocs.Conversion.Mcp 伺服器、Claude、Cursor 或 GitHub Copilot,只需一個提示即可在本機執行:
Convert report.pdf to Markdown
一步步的設定與除錯說明請參考文件:如何使用 MCP 伺服器將 PDF 轉換為 Markdown
為何 Markdown 步驟決定您的 RAG 索引品質?
檢索管線只能索引轉換步驟保留下來的內容。若表格被展平成一串數字,該表格的片段將無法回答任何問題。若標題消失,分塊器就沒有章節邊界可遵循。您最想放入私人知識庫的文件,往往也是最不想送給第三方的文件:合約、內部報告、患者或客戶紀錄。選擇哪條路徑同時決定了兩件事:有多少結構得以保留,以及檔案會流向何處。
方法 1:將 PDF 上傳至線上轉換器或雲端解析 API?
這是最快的路徑,也是取捨最大的一條。檔案會離開您的機器,於您無法控制的基礎設施上處理。對於公開文件可能還能接受;但對於任何機密資料,這一步驟會被安全審查阻止。
僅在內容不敏感且您接受檔案經由他人服務往返的情況下使用此方式。
方法 2:將 PDF 文字貼到聊天中,請模型進行格式化?
此方式將處理保留在您這邊,但模型現在是改寫內容,而非轉換內容。模型只能看到您貼上的文字,表格邊框、欄位順序與頁面幾何已經遺失,模型只能透過猜測填補空缺。長文件也會在您抵達最後一頁前耗盡上下文視窗。
適合一次性的段落處理,而非整個報告資料夾。
方法 3:讓您的代理程式呼叫本機轉換引擎?
此時由代理程式決定,轉換引擎執行實際轉換。代理程式會將檔名與目標格式傳給 convert 工具,GroupDocs.Conversion 引擎會在您的文件旁寫入 Markdown 檔案。工具呼叫中的格式為 md:
{
"name": "convert",
"arguments": {
"file": { "filePath": "report.pdf" },
"format": "md"
}
}
您永遠不需要手寫這段 JSON。只要輸入一句話,代理程式就會產生呼叫。結構會以真正的 Markdown 標記保留下來:標題變成 # 與 ##,表格變成管道表格,清單變成清單項目。這正是嵌入管線與 LLM 原生可讀的格式,您可以直接將檔案餵給分塊器。
結果的形態大致如下。以下內容僅為示意,非真實執行的輸出:
# Quarterly report
## Revenue by region
| Region | Q1 | Q2 |
|---|---|---|
| North | 120 | 135 |
| South | 98 | 101 |
複雜版面是為文件忠實度而建的引擎與基本文字擷取器之間的差異所在。是否影響您的文件,需要在最困難的三個 PDF 上先測試,才決定是否採用。
如果您只需要 Markdown 輸出,GroupDocs 也提供專用的伺服器 GroupDocs.Markdown.Mcp。其文件說明它能將 PDF、Word、Excel、EPUB 以及超過 20 種格式轉換為乾淨、結構化的 Markdown,並可控制頁面選取、圖片與 front matter。當 Markdown 只是同一工作流程中多種目標格式之一時,GroupDocs.Conversion.Mcp 更為合適。針對 RAG 的比較可參考 您的 RAG 管線從 Markdown 開始 — 將此步驟保留在本機,伺服器文件則位於 docs.groupdocs.com/markdown/mcp。
如何設定本機路徑?
在客戶端註冊一次伺服器即可。以下為 Claude Desktop 的設定範例:
{
"mcpServers": {
"groupdocs-conversion": {
"type": "stdio",
"command": "dnx",
"args": ["GroupDocs.Conversion.Mcp", "--yes"],
"env": { "GROUPDOCS_MCP_STORAGE_PATH": "/path/to/documents" }
}
}
}
此設定需要 .NET 10 SDK。相同的伺服器條目可在 Cursor、VS Code 搭配 GitHub Copilot 以及 Claude Code 中使用;每個客戶端的完整設定檔列於 文件中心。設定完成後重新啟動客戶端。於評估模式或授權檔案模式下,轉換在套件下載完畢後不再需要網路;計量授權會回報使用情況,因而需要向外連線。
可使用的提示語:
將此資料夾中的所有 PDF 轉換為 Markdown,以供我的知識庫使用。
檢查 whitepaper.pdf 有多少頁,然後將其轉換為 Markdown。
第二個提示會先呼叫 get_document_info,取得檔案類型、頁數與基本屬性,之後再執行 convert。
範例對話
以下為根據文件中工具說明所示的簡化示意對話,非螢幕截圖。
You: Check how many pages whitepaper.pdf has, then convert it to Markdown.
Agent: [calls get_document_info with file.filePath = "whitepaper.pdf"]
Agent: [calls convert with file.filePath = "whitepaper.pdf", format = "md"]
Agent: Done. The Markdown file is saved as whitepaper.md in your output folder.
有哪些限制?
- 掃描檔需先進行 OCR。 只有影像的 PDF 沒有文字層,且 OCR 功能不屬於此伺服器,因此產生的 Markdown 不會包含文字。若您的 PDF 為掃描件,請先執行 OCR 後再轉換。
- 評估模式。 未取得授權時,輸出會帶有評估水印,且單一伺服器程序最多只能同時開啟 15 份文件。於大量匯入前呼叫
get_license_status以確認目前使用的模式。 - 轉換而非抽取。 此伺服器將整份文件轉換為 Markdown。若您只需要特定欄位或型別值,請改用 GroupDocs.Parser.Mcp(僅以 Docker 映像提供),在管線同時需要兩者時可同時使用。
常見問題
如何在不上傳檔案的情況下將 PDF 轉換為 RAG 用的 Markdown?
在自己的機器上執行轉換伺服器,讓代理程式呼叫它。使用 GroupDocs.Conversion.Mcp 時,convert 工具會將 .md 檔寫入您的資料夾,且不會將文件傳送至雲端服務。
PDF 轉成 Markdown 後表格會被保留嗎?
會,以 Markdown 的管道表格形式保留。請先測試您最複雜的表格,因為版面複雜度是轉換器差異最大的地方。
之後我可以把 Markdown 再轉回 PDF 或 Word 嗎?
可以。相同的伺服器支援將 Markdown 轉換為 PDF 與 DOCX,相關說明請見 匯出文章。
深入了解
- 文件、官方教學:如何使用 MCP 伺服器將 PDF 轉換為 Markdown
- 文件中心:GroupDocs.Conversion MCP 伺服器
- 從這裡開始:為何您的 AI 代理程式不應自行轉換文件
- 相關文章:自動化報告交付:讓代理程式寫 Markdown 並產出 Word
- 相關文章:一次提示處理整個資料夾:使用 Claude 與 MCP 進行批次轉換
- 公告:您的 AI 代理程式現在可以本機轉換文件 — 介紹 GroupDocs.Conversion MCP
- 本地部署與安全模型:3 種 AI 文件處理架構,哪一種能將檔案保留在您的網路內
- 問題討論:GroupDocs Conversion 論壇
- 原始碼:GroupDocs.Conversion.Mcp 在 GitHub 上的專案