document-conversion

文档与URL转Markdown,支持分层回退机制

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:document-conversion。
它的用途是:文档与URL转Markdown,支持分层回退机制
完整的 Skill 内容见:https://321skill.com/skills/document-conversion-x-5/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'将这份PDF报告转换为Markdown',它会自动尝试用MCP markitdown工具转换,若失败则调用系统原生工具(如pandoc),最后返回Markdown内容。如果两种方式都失败,AI会通知你手动处理并提供原始文件路径。

介绍

你是否经常需要将PDF、Word文档或网页内容转换为Markdown格式,却苦于转换工具不稳定或格式丢失?这个Skill通过分层回退策略,优先调用MCP markitdown工具进行高质量转换,失败时自动降级到原生系统工具,若仍无法处理则通知用户手动操作,确保最大程度的成功率和可用性。

使用非常简单:直接告诉AI你想要转换的文档路径或URL,AI会自动识别并执行转换流程。例如,对AI说’将这份PDF报告转换为Markdown’,它会依次尝试三种方式,最终返回干净的Markdown内容。整个过程无需手动切换工具,完全自动化。

这个Skill适合文档工程师、内容创作者、全栈开发者等需要频繁处理文档格式转换的人群。无论是批量转换技术文档、抓取网页内容整理知识库,还是将学术论文转换为可编辑的Markdown,它都能高效完成。

建议优先使用MCP markitdown以获得最佳转换质量;对于含复杂表格、公式或图片的文档,转换后可能需要手动检查格式。另外,URL转换依赖网络连通性,且部分需要登录的页面可能无法正常抓取。

核心特点

与同类文档转换工具相比,本Skill采用三级分层回退机制(MCP markitdown → 原生系统工具 → 用户通知),而非单一转换引擎,大幅提升了转换成功率和鲁棒性。

注意事项

不适合需要高度保密的文档转换(因可能调用外部MCP服务),以及含复杂嵌入式对象(如3D模型)的文件。

常见问题

支持哪些文档格式?

支持PDF、Word(.docx)、HTML、纯文本等常见格式,具体取决于MCP markitdown和原生工具的能力,通常覆盖大多数办公文档。

URL转换是否支持需要登录的页面?

仅支持公开可访问的URL,需要登录或验证的页面无法自动抓取,这部分会降级到用户通知。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/document-conversion-x-5/raw/index.md 读取 document-conversion 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。