前言¶

在 Agent 里处理简历、JD、作品集或汇报材料时，模型往往只能看到文件名或你手动粘贴的片段。若希望先做总结、改写、问答或结构化提取，通常需要先把 PDF、Word、PPT 等转成可编辑的 Markdown。自己搭解析链路要对接上传、轮询和结果落盘；「文档转md」这一 Skill 把 MinerU 的解析能力封装进通用 SKILL.md 工作流，由 Agent 按说明调用 bundled script，完成本地文件或远程 URL 的转换并保存 Markdown。

这是什么¶

「文档转md」是 SkillHub 上的社区 Skill（坐标 @user_ec02b303/xtyooo-mineru-doc-to-markdown-skill，版本 1.0.0，分类 office-efficiency，发布者 user_ec02b303）。它使用 MinerU 将 pdf、doc、docx、ppt、pptx、图片或 html 转为 Markdown，适合「先转 md，再进入后续工作流」的场景。

与在对话里零散粘贴正文不同，该 Skill 强调通过脚本完成上传、远程解析、轮询和保存，便于把同一份文档稳定地交给后续步骤。

核心功能¶

下面介绍已见于官方简介与 SkillHub 页面的能力，不展开未公开的脚本参数。

1. 格式覆盖：支持 pdf、doc、docx、ppt、pptx、图片、html 转 Markdown。
2. 两种 API 路径：优先读取环境变量 MINERU_API_TOKEN，调用精准解析 API；未配置 token 时，自动降级到免 token 的 Agent API。
3. 输入方式：bundled script 支持本地文件上传与远程 URL 解析，并在任务完成后保存 Markdown 输出。
4. 典型上游场景：官方说明中列举简历、JD、作品集等文档，转 md 后可用于总结、改写、问答、结构化提取或接入其他工作流。
5. 标签说明：Skill 带有 requires_api_key=true；是否配置 MINERU_API_TOKEN 会影响走精准 API 还是降级路径，而非一律不可用。

安装与启用¶

SkillHub 页面给出的安装方式是：让 AI 按 SkillHub 安装文档 安装本 Skill。坐标如下。

@user_ec02b303/xtyooo-mineru-doc-to-markdown-skill

若本机已安装 skillhub CLI，可按安装文档第三节，用 --dir 指向当前 Agent 的 skills 目录（装到默认 ./skills/ 可能不会被识别）。示例命令形态如下，请将 <skills 目录> 换成你环境对应的路径。

command -v skillhub && skillhub --version

skillhub install @user_ec02b303/xtyooo-mineru-doc-to-markdown-skill --dir <skills 目录>

安装文档中列出的常用 skills 目录包括：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

CLI 尚未安装时，可按文档使用官方安装脚本（完整安装或 --cli-only），具体命令见 https://skillhub.cn/install/skillhub.md 第一节。

启用精准解析前，在运行 Agent 或执行脚本的环境中配置：

export MINERU_API_TOKEN="<你的 MinerU API Token>"

未设置时，Skill 说明会走免 token 的 Agent API 降级路径。

典型用法¶

官方未在公开页面给出单独的 shell 示例；可复现的使用方式是与 Agent 协作，由 Skill 指导调用 bundled script。可按下面顺序操作。

1. 完成 Skill 安装，并视需要设置 MINERU_API_TOKEN。
2. 在对话中说明需求，例如：将某份 PDF 简历或某 JD 的 docx 转为 Markdown，并指定本地路径或文档 URL。
3. Agent 按 Skill 说明执行：上传本地文件或提交远程 URL、轮询 MinerU 解析任务、将结果保存为 Markdown 文件或返回内容。
4. 在得到的 Markdown 上继续让 Agent 做总结、改写、问答或字段抽取。

若你使用 Cursor，安装目录应为 ~/.cursor/skills/；安装或更新 Skill 后，若 Agent 未加载新技能，可按你所用客户端的惯例重启或刷新技能列表。

适用场景与注意¶

适合谁：需要在 Agent 内处理多格式办公文档、且希望统一走 MinerU 解析链路的开发者或效率向用户；分类为 office-efficiency，与文档预处理场景一致。

使用注意：

• 精准解析依赖 MINERU_API_TOKEN；无 token 时使用降级 API，解析质量或配额以 MinerU 与 Skill 实际行为为准，安装前可在对话中确认当前走哪条路径。
• Skill 为社区来源（community），维护与 MinerU 服务变更需自行关注 SkillHub 上的版本更新（当前页面标注 v1.0.0）。
• 涉及简历、JD 等敏感文件时，上传与 URL 解析会经过 MinerU 相关服务，请按组织合规要求评估。

SkillHub 页面展示的统计（以页面与抓取资料为准）：评分 100000，下载 2132，安装 21。具体数字以你访问 SkillHub 时为准。

结尾¶

「文档转md」把 MinerU 的多格式解析和 Markdown 落盘收敛成一个可安装的 Agent Skill，用环境变量切换精准 API 与免 token 降级，适合把文档先变成 md 再接入后续自动化。官方入口：

• SkillHub：https://www.skillhub.cn/skills/user_ec02b303/xtyooo-mineru-doc-to-markdown-skill
• API 坐标页：https://api.skillhub.cn/user_ec02b303/xtyooo-mineru-doc-to-markdown-skill