前言¶
处理用户上传的附件时，PDF、Word、Excel、PPT 这些格式没法直接进对话，得先本地装一堆转换库、写临时脚本，做完还要清理环境。这类需求重复出现，每次都重新造轮子成本不低。下面介绍的 Skill 用微软开源的 MarkItDown 把这件事收敛成一个固定动作：把文件交给它，拿回 Markdown 文本。
这是什么¶
「万能文件转 Markdown」是一个基于通用 SKILL.md 格式的社区 Skill，坐标 @user_825f001d/markitdown，分类 office-efficiency，发布者 user_825f001d，来源 community，当前版本 1.0.0。
它的底层是微软开源的 MarkItDown 0.1.8。解决的问题是：把 PDF、Word、Excel、PPT、HTML 等常见文档格式统一转成 Markdown，让对话模型能直接读取附件内容，不需要用户自己准备转换环境。
SkillHub 页面上的评分为 100000，下载量 1384 次（截至抓取时）。标签显示 requires_api_key=false，即不需要额外配置 API Key。
核心功能¶
支持的输入格式来自页面简介，逐条列出：
- Word（docx）
- Excel（xlsx）
- PPT（pptx）
- HTML
- CSV
- JSON
- XML
- EPUB
- RSS
- ZIP
- 图片（提取 EXIF 信息）
批量转换，即可以一次处理多个文件，而不是单个文件手工跑一遍命令。转换结果统一为 Markdown 文本，可直接读入对话上下文。
触发场景按页面描述：用户要求「把 PDF/Word/Excel/PPT 转成 markdown」「提取这份文档的内容」「docx 转 md」「网页转 markdown」，或需要把 Office 附件内容读入对话时使用。
安装与启用¶
该 Skill 已预装在托管 venv 中，本机不需要再执行 pip install。启用方式就是把它安装到你的 Agent 环境：
SkillHub 页面：https://www.skillhub.cn/skills/user_825f001d/markitdown
官方地址：https://api.skillhub.cn/user_825f001d/markitdown
在 Cursor、Codex CLI、Claude Code 中的具体安装入口，抓取资料里没有区分说明，这里不补充未经核实的步骤。从 SKILL.md 的通用格式来看，把 Skill 目录放进对应的 skills 目录即可被识别，具体路径以各工具的文档为准。
典型用法¶
由于本机已装在托管 venv，实际调用方式就是让 Agent 在用户提出转换需求时自动触发，例如：
用户：「把这份 docx 转成 markdown，我要看看里面的内容。」
Agent 识别到附件是 Office 文档，走这个 Skill 把 docx 转成 Markdown 后返回文本。同样的流程适用于 PDF、xlsx、pptx、网页和 CSV。
命令行层面的对应操作由底层 MarkItDown 提供，例如对单个文件做转换。这里只描述到 Skill 这一层：触发条件明确（用户提出文档转换或内容提取诉求），输入是常见文档格式，输出是 Markdown 文本。
适用场景与注意¶
适合的场景：
- 需要把用户上传的 Office 附件内容读进对话，但不想在本地维护各类文档解析依赖。
- 批量处理一批 PDF、docx、xlsx、pptx 文件，统一拿到 Markdown 文本再做后续处理。
- 网页、CSV、JSON、XML 等结构化或半结构化内容要转成可读文本。
需要注意的地方：
- ZIP 是解包取内容，图片只提取 EXIF 信息，这两类不是把二进制本身转成可读正文。
- 转换质量取决于源文档的格式规范程度，复杂排版、扫描版 PDF 的效果以实际运行为准，资料里没有给出质量承诺。
- 当前版本 1.0.0，社区来源，更新节奏看发布者。
- 不需要 API Key，但 MarkItDown 依赖托管 venv 里的 Python 环境，环境不可用时转换会失败。
结尾¶
这个 Skill 的价值在于把「文档转 Markdown」从一次性脚本变成环境里常备的能力：格式覆盖面广，批量处理，不需要 API Key，本机已装好。需要把 Office 附件内容读入对话时，先走它转成 Markdown，再进入后续处理。
官方地址：https://api.skillhub.cn/user_825f001d/markitdown
SkillHub 页面：https://www.skillhub.cn/skills/user_825f001d/markitdown
