要将文档迁移到 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。报告每个文件的格式、页数和输出大小。
-
找出未成功转换的文件。
列出转换后在超过 5 页的情况下产生少于 2 KB Markdown 的 PDF。
这些几乎总是扫描件。此服务器没有 OCR 步骤，因此需要使用其他工具，或保持为通过元数据索引的 PDF。
-
修正模式，然后分批运行其余文件。 每轮二十个文件，每次都有报告，这样可以让运行可审查，并使计量使用可预测。
-
像审查 pull request 那样审查输出。 接下来的章节列出了需要关注的内容。
| 决定 | 代理 | 引擎 |
|---|---|---|
| 要转换哪些文件、顺序以及批量大小 | 是 | 否 |
要传递的选项 (images、frontMatter、flavor) |
是，来自你的提示 | 否 |
| 将标题、列表和表格转换为 Markdown | 否 | 是 |
保存 .md 和图像文件 |
否 | 是 |
| 发现一个 300 页的文件被转换为 4 KB | 是，来自报告 | 否 |
| 重命名、文件夹布局、额外的 front-matter 键 | 是 | 否 |
哪些格式迁移效果好？
- 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 服务器
- 从这里开始： 你的 RAG 流水线从 Markdown 开始 — 保持此步骤本地
- 相关： 使用 MCP 将所需章节提取到 Markdown 的 3 种方法
- 相关： 从文档到静态站点：通过 AI 代理使用 Hugo、Docusaurus 或 MkDocs
- 本地部署与安全模型： AI 文档处理的 3 种架构，以及将文件保留在网络内部的方案
- 问题讨论： GroupDocs Markdown 论坛
- 源代码： GitHub 上的 GroupDocs.Markdown.Mcp