前言¶

把 PDF、Word、表格或演示稿里的内容搬进知识库、Issue 或仓库文档时，常见做法是手工复制，或自己搭一套转换脚本。格式一多，维护成本会上去。下面介绍 SkillHub 上的 MarkItDown转换（坐标 @org-02qudk26/markitdown-cn）：在 Agent 侧挂载统一技能后，由 Agent 按技能说明处理「文件 → Markdown」这一类任务，减少你为每种格式单独写流程。

这是什么¶

MarkItDown转换 是智雨科技在 SkillHub 发布的 enterprise 来源 Skill，分类为 office-efficiency，当前版本 1.0.0。定位一句话：将文件和办公文档转换为 Markdown 格式。页面标注 requires_api_key=false，即不依赖额外 API Key 配置（具体仍以实现该 Skill 的 SKILL.md 为准）。

SkillHub 展示页：https://www.skillhub.cn/skills/org-02qudk26/markitdown-cn
API 入口（元数据）：https://api.skillhub.cn/org-02qudk26/markitdown-cn

核心功能¶

以下能力均来自官方简介，未在资料中出现的格式或选项不写。

技能本身遵循通用 SKILL.md 格式，由 Agent 读取后决定具体调用方式与参数。

安装与启用¶

SkillHub 页面给出的安装方式是：让 AI 按官方安装文档处理，并安装坐标 @org-02qudk26/markitdown-cn。通用流程见 https://skillhub.cn/install/skillhub.md。

1、检查或安装 SkillHub CLI¶

先确认本机是否已有 skillhub：

command -v skillhub && skillhub --version

未安装时，可用官方脚本（完整安装含 CLI 与默认 Skill）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

仅需 CLI 时：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

2、安装到当前 Agent 的 skills 目录¶

安装技能时必须用 --dir 指向当前 Agent 实际读取的 skills 目录；默认装到 ./skills/ 可能不会被识别。官方文档列出的常见路径如下：

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

示例（Cursor 环境，目录请按本机调整）：

skillhub install org-02qudk26/markitdown-cn --dir ~/.cursor/skills/

若坐标与包名有差异，以 skillhub search markitdown 或 SkillHub 页面显示的 @org-02qudk26/markitdown-cn 为准。

3、启用¶

安装完成后重启或刷新 Agent，使新 skills 目录被加载；具体是否需重启以你所用客户端说明为准。安装后请阅读该 Skill 目录内的 SKILL.md，其中才是可执行步骤与约束的权威来源。

典型用法¶

公开页面未附带独立的命令行演示或样例仓库链接，因此这里只写可复现的协作方式，不编造脚本或虚构案例。

1. 按上一节将 @org-02qudk26/markitdown-cn 安装到对应 skills 目录。
2. 在对话中说明源文件路径或提供文件，并明确要求输出为 Markdown（例如：「用 MarkItDown 技能把这份 PDF 转成 Markdown，保留标题层级」）。
3. Agent 根据 SKILL.md 选择转换路径；图片 OCR、音频转录等是否在单次任务中启用，以技能文档描述为准。

需要确认支持的后缀或压缩包内文件规则时，以安装包内 SKILL.md 与 SkillHub 简介为准。

适用场景与注意¶

适合谁

• 经常在 Cursor、Claude Code、Codex 等环境里处理杂格式办公文件，希望用同一套 Agent 技能收口转换的人。
• 希望减少「为 PDF / Office / 表格各写一个小工具」的维护负担的团队。

注意

• 简介中的「ZI」在网页展示处被截断，使用前请在 SKILL.md 中核对完整类型名与限制。
• OCR、音频转录对质量、语言与文件大小的实际表现取决于技能实现与运行环境，资料中未给出 benchmark，此处不做性能承诺。
• SkillHub 页面统计（截至抓取）：评分 100000，下载 1545，安装 0；与第三方摘要中的数字可能不一致，以 SkillHub 为准。
• 企业来源（enterprise）技能，在合规与内网策略上请按你方对 SkillHub enterprise 源的规范评估后再装。

结尾¶

MarkItDown转换 把多类办公与数据文件收敛到「转 Markdown」这一件事上，适合挂在 Agent 的 skills 里做日常文档预处理。安装与坐标以 SkillHub 为准：

• 技能页：https://www.skillhub.cn/skills/org-02qudk26/markitdown-cn
• 安装说明：https://skillhub.cn/install/skillhub.md
• 坐标：@org-02qudk26/markitdown-cn