MinerU 文档转 Markdown

解决什么问题

当文档是 PDF、DOC/DOCX、PPT/PPTX、图片或 HTML 时，直接复制正文常会丢失标题层级、表格边界和阅读顺序，也难以继续总结或交给 LLM。该技能将文档转为 Markdown，重点解决转换结果不够稳定、临时请求太分散，以及有 token 与无 token 模式难以统一的问题。

如何工作

它使用 MinerU 的两条解析链路：

• 精准解析模式：存在 MINERU_API_TOKEN 或指定 --mode precise 时触发。本地文件会申请上传地址、上传并轮询任务，最终下载 full_zip_url 并提取 full.md；远程 URL 则创建批量提取任务后轮询结果。
• 轻量 Agent 模式：无 token 或指定 --mode agent 时触发。本地文件和远程 URL 都通过 Agent API 创建任务，轮询后下载 markdown_url。

默认输出到 outputs/mineru/，日志写入 logs/mineru_markdown.log。full.md 是主产物，.zip 用于排查或复用。转换成功后，应继续读取 Markdown，而不是重复请求转换服务。

适用边界

它适合文档转 Markdown，不适合 xlsx/csv 表格，也不建议用于已贴出文本只要摘要的场景。本地文件和远程 URL 不要混用；大文件在 Agent 模式下限制更严，失败时优先查看 MinerU 错误并考虑拆分文档。