1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | convert-word-to-md（合集仓库子技能，收录识别名 convert-word-to-md-github-awesome-copilot） |
— |
| 作者/维护者 | GitHub（github/awesome-copilot 官方合集仓库；该子技能由社区贡献者 1YaoWei0 于 2026-07 提交并经维护者审阅合并） |
GitHub API |
| 来源链接 | https://github.com/github/awesome-copilot/tree/main/skills/convert-word-to-md | — |
| 许可证 | MIT（仓库级） | GitHub API |
| GitHub Stars / Forks | 39,137 / 4,971（属整个 awesome-copilot 合集仓库，不代表本技能自身热度） | GitHub API |
| 最新版本 | 无独立版本号，随仓库滚动更新；该子技能最近一次内容改动 2026-07-15 | GitHub API（按路径过滤的提交记录） |
| 安装方式 | gh skills install github/awesome-copilot convert-word-to-md，或 npx skills add https://github.com/github/awesome-copilot --skill convert-word-to-md，或手动复制 skills/convert-word-to-md/ 目录 |
官方文档 |
2. 功能介绍与亮点
convert-word-to-md 把 Word（.docx）文档转换成 Markdown，让 agent 能准确读取、总结、搜索、对比或提取 Word 文档（简历、报告、合同、方案）里的内容。
- 隐式自动触发：用户只要提到、附上或询问某个
.docx文件，即使没说“转换”或“markdown”也会触发，并要求先跑随附脚本、不要让 agent 临时手写解析代码。 - 真实图片提取：底层用 MarkItDown 做文字与表格转换；MarkItDown 自身只给图片留截断的 base64 占位符，本技能额外从 .docx 压缩包里按文档顺序取出真实图片，写成
<name>/img/img001.png并把 Markdown 里的引用改成相对路径。 - 批量模式：可指定整个文件夹，
--recursive递归子目录；单个文件损坏或有密码不影响同批其他文件。 - 多格式协同：文件夹里同时有 PDF、Word、Excel 时，会同时调用同仓库的 convert-pdf-to-md、convert-excel-to-md，避免漏转某种格式。
- 完整故障排查表：对照报错信息给出原因与修法；遇到旧版
.doc会明确提示先另存为.docx。
3. 适用场景
固定分类：文档与办公自动化
适合需要让 agent 阅读、分析 Word 文档，但 agent 不擅长直接解析 .docx 压缩包格式的场景：行政与法务批量整理合同和方案、招聘人员筛选简历、分析师从 Word 报告中提取表格与图片、把一批 Word 文档整理进知识库。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——遵循 Agent Skills 规范（SKILL.md + YAML front matter），复制到
.claude/skills/即可加载。 - Codex CLI：⚠️ 需适配——Codex 不会自动扫描
~/.codex/skills，需在会话中手动引用 SKILL.md 内容。 - OpenClaw：❓ 未验证——未查到官方文档说明其对第三方 SKILL.md 的加载方式。
- Hermes Agent：✅ 原生支持——Hermes 按 tap 路径扫描子目录探测 SKILL.md，兼容标准 Agent Skills 规范。
5. 推荐理由
Word 文档对 agent 来说是“打不开的压缩包”，临时手写解析既慢又容易漏图漏表。这个技能把流程固化成一条确定性的命令：一次 pip install 之后离线运行，无需付费 API 或联网，转换结果是一个自带图片目录的自包含文件夹，agent 直接读 Markdown 即可。对经常让 agent 处理 Word 材料的人，它省掉的是每次重新摸索解析方案的时间。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | GitHub 官方合集出品；独立目录站 skills.sh 显示该技能累计 79 次安装（2026-07-16 首次出现）；合集仓库 stars 不代表本技能自身热度 |
| 可用性 | 8 | 需先装 Python 3.10+ 与 markitdown（附 setup.md 分步指引），装好即用；文档含用法、输出结构、故障表；2026-07 仍有改动。实测在干净虚拟环境安装后成功转换含标题、段落与表格的 .docx；setup.md 称依赖为“固定版本”，而 requirements.txt 实际写的是 markitdown[docx]>=0.1.0（下限而非固定）。 |
| 安全性 | 9 | 见下方检查清单：本地脚本、无联网、无凭据、License 明确、官方仓库可审计 |
安全检查清单：①执行本地 Python 脚本，仅读取用户指定的 .docx 并写出 Markdown 与图片，无 shell 调用 ②运行时无联网外发（安装依赖时需联网 pip） ③不需要 API key 或凭据 ④SKILL.md 与脚本未见可疑指令或夹带推广；图片以 img001.ext 规范名写出，不使用压缩包内原路径 ⑤作者为 GitHub 官方仓库，信誉良好 ⑥License 明确（MIT） ⑦仓库近日仍有提交，该子技能 2026-07 有改动。综合 = 三项均值。
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| anydoc（Firecrawl） | 一条命令零安装，把 Word/PPT/Excel/PDF 等 20 余种格式转成 Markdown | 覆盖格式更广、npx 一条命令免预装；本技能只做 .docx，但针对 Word 文档补了真实图片提取、按文档命名的自包含输出目录与批量模式，并附分步环境指引与故障表 |
| docx（Anthropic 官方 skills） | 以创建、编辑 Word 文档为主 | 侧重“生成/改写 Word”；本技能侧重“读出 Word 里的内容”供 agent 分析 |
| 直接使用 MarkItDown | 通用文档转 Markdown 库 | 图片只留占位符；本技能在其上补了真实图片提取、按文档命名的输出目录与批量模式 |
8. 用户评价
该技能目前在第三方平台尚无具名用户使用评价。可核实的公开痕迹：贡献 PR（github/awesome-copilot#2294）经维护者 aaronpowell 与审阅者 bishop335 评审，贡献者按意见修复后于 2026-07-15 合并；该 PR 的 lint 检查全部通过，风险扫描无高危项。以上是代码评审记录，不是使用者评价。
9. 其他补充
与 convert-pdf-to-md、convert-excel-to-md 同批提交，三者共用一套输出约定（<name>/ 目录 + img/ 子目录）。正文为英文，暂无多语言版本。
10. 安装使用方式
- 安装技能：
gh skills install github/awesome-copilot convert-word-to-md（需 GitHub CLI），或npx skills add https://github.com/github/awesome-copilot --skill convert-word-to-md，或手动复制目录。 - 安装依赖（一次即可）：
python -m pip install -r scripts/requirements.txt。 - 使用：让 agent 处理任意 .docx 即自动触发；也可手动运行
python scripts/convert_word_to_md.py "/path/to/document.docx"，默认在源文件旁生成document/文件夹；文件夹批量加--recursive，需要指定输出位置时加-o。
安装后无需重启。
11. 注意事项
- 仅支持
.docx；旧版.doc需先在 Word 中另存为.docx。 - 需要 Python 3.10+ 与 pip 联网安装依赖；受限沙箱里若不能联网需提前装好。
- 转换质量取决于 MarkItDown：无表头样式的表格可能得到空表头行（实测所得），复杂排版、批注、文本框不保证保留。
- 输出默认写在源文件旁边，批量转换会在原目录生成多个子文件夹。
- 该子技能最近一次内容改动为 2026-07-15，后续 MarkItDown 版本升级可能带来行为差异，因依赖只设下限，建议自行固定版本。