前言¶
技术写作和内容运营里，常见痛点是源文件格式不统一：交付物是 Word、PDF、网页导出或表格，仓库和 CMS 却要求 Markdown。手工复制粘贴会丢表格结构、图片引用和层级标题，批量处理更费时。
下面介绍 SkillHub 上的社区 Skill「MarkItDown 文档格式转换工具」。它在 Agent 侧封装微软开源的 markitdown 能力，把多种办公与网页格式转成 Markdown，并声明支持批量与自定义规则，适合需要统一文档形态、又不想每次手写转换脚本的人。
这是什么¶
MarkItDown 文档格式转换工具（坐标 @user_922b1001/markitdown-wrap，版本 1.0.0）是 SkillHub 分类 office-efficiency 下的社区 Skill，发布者为 user_922b1001，标签 requires_api_key=false，安装与使用不依赖额外 API Key。
一句话定位：在 AI Agent 工作流里，把 Word（.docx）、PDF、HTML、Excel 等文档转为 Markdown，并尽量保留版式、表格与图片引用等关键信息。Skill 说明写明基于微软开源 markitdown 项目封装；对应封装仓库见 q15004040209-creator/markitdown-wrap。
SkillHub 页面：https://www.skillhub.cn/skills/user_922b1001/markitdown-wrap
核心功能¶
以下能力均来自 SkillHub 简介与元数据，未在公开页单独展开的实现细节不作延伸：
- 多格式入、Markdown 出：支持 Word（
.docx）、PDF、HTML、Excel 等常见文档类型的一键转换。 - 信息保留：面向保留原文档格式结构、表格与图片引用等，减少「纯文本化」带来的信息损失。
- 批量与规则：支持批量转换；支持自定义转换规则（具体规则字段以安装后的 Skill 说明为准）。
- 无 API Key：
requires_api_key=false，降低接入门槛。
底层转换能力归属微软开源 markitdown；本 Skill 是在 Agent 场景下的安装与使用封装。
安装与启用¶
Skill 遵循通用 SKILL.md 格式。在 SkillHub 生态里，推荐先具备 skillhub CLI，再把技能装进当前 Agent 实际读取的 skills 目录（装错目录 Agent 不会加载）。
1、检查或安装 SkillHub CLI¶
command -v skillhub && skillhub --version
若未安装，可按 SkillHub 安装文档执行完整安装（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
安装步骤与路径说明见：https://skillhub.cn/install/skillhub.md
2、安装本 Skill¶
必须用 --dir 指向当前环境的 skills 目录，否则默认落在 ./skills/，多数 Agent 不会识别。
skillhub install @user_922b1001/markitdown-wrap --dir <你的 Agent skills 目录>
常用目录示例（以 SkillHub 文档为准）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
Cursor 示例：
skillhub install @user_922b1001/markitdown-wrap --dir ~/.cursor/skills/
3、通过对话让 Agent 安装（可选）¶
SkillHub 页面提供的提示词形式为：让 Agent 阅读 skillhub.md 安装说明，并安装 @user_922b1001/markitdown-wrap。适合尚未配置 CLI、但希望由 Agent 代为拉取技能的场景。
安装或更新 Skill 后，按你所用 Client 的要求重启或刷新 Agent，使新技能生效。
典型用法¶
公开 SkillHub 页未给出单独的命令行转换示例；可复现的接入方式如下。
方式 A：CLI 安装后，在对话中发起转换
- 确认
@user_922b1001/markitdown-wrap已出现在 Agent 的 skills 目录。 - 在对话中说明：源文件路径（或目录）、目标 Markdown 输出位置、是否需要批量处理、是否有自定义规则需求。
- 由 Agent 按 Skill 内指引调用封装好的 markitdown 流程，生成
.md或等价产物。
方式 B：安装提示词（与 SkillHub 页面一致）
将下列意图发给 Agent（路径与目录按你的环境替换）：
请根据 https://skillhub.cn/install/skillhub.md，安装 @user_922b1001/markitdown-wrap。
安装完成后，把 /path/to/source.docx 转为 Markdown，输出到 /path/to/output.md。
若需批量，在同一轮对话中列出目录与命名规则即可；Skill 简介已声明支持批量与自定义规则，具体参数以安装包内 SKILL 说明为准。
适用场景与注意¶
适合谁
- 技术写作者：把 Word/PDF 规格、评审稿统一进 Git 或静态站点管线。
- 内容运营与文档工程师：多来源稿件归一为 Markdown，便于 diff、模板与发布。
- 已在用 Cursor、Claude Code、Codex 等支持 Skills 的 Client，希望转换步骤留在对话里、少写一次性脚本的人。
使用上注意
- 目录要对：
skillhub install的--dir必须对应当前 Agent 的 skills 路径，否则表现为「已安装但 Agent 不用」。 - 效果因源文件而异：扫描版 PDF、复杂版式或嵌入对象多的 Office 文件，转换质量取决于 markitdown 与源文件本身；复杂版式仍可能需要人工校对。
- 公开资料粒度：GitHub 仓库 markitdown-wrap 当前公开说明较简，细粒度配置项请以安装后的 Skill 包内容为准，勿假设未文档化的字段。
- 社区来源：
source: community，升级与维护节奏跟随发布者；重要生产流程建议固定版本并自行验证样例文件。
结尾¶
MarkItDown 文档格式转换工具把 markitdown 的多格式转 Markdown 能力接到 Agent Skills 上，面向 .docx、PDF、HTML、Excel 等统一输出，并强调表格与图片引用等信息的保留，配合批量与规则能力，适合办公效率类文档流水线。
安装与详情见 SkillHub：https://www.skillhub.cn/skills/user_922b1001/markitdown-wrap；封装来源：https://github.com/q15004040209-creator/markitdown-wrap。API 入口：https://api.skillhub.cn/user_922b1001/markitdown-wrap。
