要將文件遷移到 Markdown，將存檔資料夾交給 AI 代理，讓它對每個檔案執行一次 convert_to_markdown，以已審核的批次進行。使用 GroupDocs.Markdown.Mcp，這個過程會在 Claude Code、Cursor、GitHub Copilot 或其他 MCP 客戶端本地執行，因此內部程序的存檔永遠不會上傳至轉換服務：
將存檔資料夾中的所有內容轉換為帶有 front matter 且圖片作為檔案的 Markdown。針對每個檔案報告來源格式、頁數以及輸出大小。
包含設定與故障排除的逐步說明位於文件中：如何使用 AI 將舊有文件遷移至 Markdown
為何舊有文件遷移是代理的工作？
轉換是機械性的，相關工作也很重複：列出檔案、逐一轉換、測量結果、找出失敗項目、重複。讓人手動處理數百個檔案會一次又一次做相同的決策。代理能一致地完成這些工作並報告每個結果，而產生 Markdown 的是引擎而非模型。儲存的 Markdown 並不是對您程序的意譯。
這是一份作業手冊。每個步驟都有一個提示，之後的表格區分了代理的決策與引擎的執行。
作業手冊：如何將 Word 存檔遷移至 Markdown？
-
在任何操作之前先檢查授權。
在開始轉換之前：markdown 伺服器的授權狀態是什麼？
get_license_status會回傳mode、licensed、consumption以及伺服器與引擎的版本。評估模式每個文件僅處理 3 頁，因此未授權的執行會產生看似合理的草稿。 -
清點存檔。
列出存檔資料夾中每個檔案的格式、頁數以及是否加密。
Markdown 伺服器沒有資料夾列舉工具，因此代理會使用客戶端自身的檔案存取功能列出資料夾，或根據您提供的檔名工作。
接著
get_document_info會回傳每個檔案的fileFormat、pageCount、title、author與isEncrypted，且不會進行轉換。加密檔案需要提供password參數。 -
執行約二十個檔案的試點。
將前二十個文件轉換為帶有 front matter 且圖片作為檔案的 Markdown。針對每個檔案報告格式、頁數與輸出大小。
-
找出未成功轉換的檔案。
列出那些轉換後產生少於 2 KB Markdown 且頁數超過 5 頁的 PDF。
這類檔案幾乎都是掃描件。此伺服器沒有 OCR 步驟，因此需要使用其他工具，或保留為以中繼資料索引的 PDF。
-
修正模式，然後分批執行其餘檔案。 每輪二十個檔案，並每次產生報告，讓執行過程可審核且計量使用量可預測。
-
像審查 Pull Request 那樣檢視輸出。 接下來的章節列出需要留意的項目。
| 決策 | 代理 | 引擎 |
|---|---|---|
| 要轉換哪些檔案、以何種順序及批次大小 | Yes | No |
要傳遞哪些選項 (images, frontMatter, flavor) |
Yes, from your prompt | No |
| 將標題、清單與表格轉換為 Markdown | No | Yes |
儲存 .md 與圖片檔案 |
No | Yes |
| 發現一個 300 頁的檔案只剩 4 KB | Yes, from the report | No |
| 重新命名、資料夾結構、額外的 front-matter 鍵 | Yes | No |
哪些格式遷移效果佳？
- DOCX、DOC、RTF、ODT。 原始檔的結構明確，標題與表格能清晰保留。
- EPUB 與 MOBI。 章節結構對應到 Markdown 標題。
- CHM。 舊式說明檔，常是唯一的程序副本。
- XLSX。 工作表會變成表格，適合參數清單。
審查階段應檢查什麼？
請求代理先執行首次掃描，然後自行閱讀樣本：
對每個已轉換的檔案，列出其引用的圖片，並告訴我哪些圖片檔案遺失。
顯示五個相對於頁數大小最小的輸出。
使用 images: "file" 寫入的圖片會與 .md 檔案放在同一目錄，並以相對路徑引用，這正是文件倉庫所期待的。若 .md 指向從未寫入的圖片，會顯示為破圖。接著在套用模式於其餘檔案前，先將最雜亂的來源與其輸出並排開啟。使用您慣常的 git 工作流程提交審查過的結果；伺服器負責寫入檔案，並不會觸及您的倉庫。
範例會話（節錄）
You: Convert the first twenty documents in /archive to Markdown with front matter
and images as files. Report format, pages and output size for each.
Agent: convert_to_markdown (frontMatter: true, images: "file") x 20
ops-manual-2014.docx DOCX 88 pages converted
install-guide.chm CHM 41 pages converted
supplier-forms-2009.pdf PDF 12 pages 1 KB of Markdown: probably a scan
Nineteen files look consistent; one scan needs separate handling.
誠實的限制
若未取得授權，評估模式僅處理每份文件的前 3 頁，且每頁會加上評估水印。以此狀態執行遷移會產生數百個看似正確的短檔案，而缺口往往在數週後才被發現，當有人搜尋到缺失的程序時。遷移必須取得授權，因此在第一批之前執行 get_license_status。掃描的 PDF 無法轉換。
常見問題
我可以一次將數百個 Word 文件轉換為 Markdown 嗎？
可以，但不能一次完成。請以約二十個為一批進行轉換，並在每批之後閱讀報告，這樣錯誤的選項就能在套用至整個存檔前被修正。
我該如何使用 AI 代理將文件遷移至 git？
伺服器會將 .md 檔案與圖片寫入輸出資料夾。您檢查後，使用慣常的 git 工作流程提交它們。
文件即程式碼的遷移會上傳我的文件嗎？
不會。GroupDocs.Markdown.Mcp 為本地處理，存檔從磁碟讀取。只有代理在對話中寫入的內容會傳送至模型提供者。
深入了解
- 文件說明、官方操作指南：如何使用 AI 將舊有文件遷移至 Markdown
- 文件中心：GroupDocs.Markdown MCP Server
- 從這裡開始：您的 RAG 流程從 Markdown 開始 — 請將此步驟保留在本地
- 相關文章：使用 MCP 將所需段落拉入 Markdown 的 3 種方法
- 相關文章：從文件到靜態網站：透過 AI 代理使用 Hugo、Docusaurus 或 MkDocs
- 本地部署與安全模型：AI 文件處理的 3 種架構，以及將檔案保留在您網路內的方案
- 問題討論：GroupDocs Markdown 論壇
- 原始碼：GroupDocs.Markdown.Mcp on GitHub