document-conversion
文档和URL转Markdown，分层回退保证成功率
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：document-conversion。 它的用途是：文档和URL转Markdown，分层回退保证成功率 完整的 Skill 内容见：https://321skill.com/skills/document-conversion-x-7/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'将这份PDF报告转换为Markdown格式'，它会自动识别文件类型，先尝试使用MCP markitdown进行转换，若失败则调用本地pandoc工具，最后返回Markdown内容。若全部失败，会提示用户手动上传或检查文件。
对AI说：'把https://example.com/article转为Markdown'，它会抓取网页内容并依次尝试转换，最终输出结构化Markdown。
介绍
文档格式转换是日常工作和AI协作中的高频需求，但不同工具各有局限——MCP markitdown对某些格式支持不全，本地工具可能缺失依赖，手动转换又费时。本Skill通过分层回退策略解决这一痛点：优先调用MCP markitdown进行快速转换；若失败，自动降级到本地原生工具（如pandoc、python-markdown库）；若仍失败，则向用户发送通知，提示手动处理或提供替代方案，确保每次转换都有结果。
使用方式极其简单：只需提供文档路径（支持PDF、Word、HTML、TXT等常见格式）或网页URL，Skill会依次尝试各级转换器，最终返回标准Markdown内容。用户无需关心底层调用哪个工具，也无需安装额外依赖——Skill会自动检测环境并选择合适的回退路径。整个过程透明，仅在降级时通过通知告知用户。
适合需要频繁将文档、网页内容转为Markdown的用户群体，包括文档工程师（整理技术文档）、内容创作者（采集素材）、数据分析师（清洗非结构化数据）、高校学生（整理课程资料）以及智能体开发者（为AI准备训练数据）。也适合在CI/CD流程中自动将设计稿或报告转换为可编辑的Markdown。
建议在使用前确保网络畅通（以便MCP markitdown正常工作），并安装本地常用转换工具（如pandoc）以提高回退成功率。对于包含复杂表格、精确图片位置或特殊排版（如数学公式、多层嵌套）的文档，转换结果可能丢失部分样式，建议后续手动校验。另外，对于超大文件（>50MB），建议分块处理或直接使用本地工具。
核心特点
同类Skill通常只依赖单一转换器（如MCP markitdown或pandoc），失败即报错；本Skill通过三层回退（MCP→原生工具→用户通知）确保高可用性，且用户无需手动选择降级方案。
注意事项
不适合需要保留复杂排版（如表格嵌套、图片精确位置、数学公式）的高保真转换场景，部分格式细节可能丢失。
常见问题
支持哪些文件格式？
支持PDF、Word（.docx）、HTML、纯文本、网页URL等常见格式，Markdown文件本身也会被识别并直接返回。
转换失败怎么办？
Skill会自动尝试下一级回退方案：先MCP markitdown，再本地工具，最后通知用户手动处理。如果所有方案都失败，会返回错误信息和具体建议。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/document-conversion-x-7/raw/index.md 读取 document-conversion 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/document-conversion-x-7/raw/index.md（查看排版版本）