Word 转 Markdown,一行命令搞定------AI 技能「docx2md」使用指南
痛点
客户 / 同事发来 Word 需求文档,想丢给 AI 分析、出方案、写代码。但 AI 读不了 .docx,你得先手动转成纯文本,排版还乱了。
解决方案
docx2md --- 把 .docx / .doc 一键转成 Markdown,图片自动提取,排版不丢。
效果:标题、列表、加粗斜体、表格、图片......完整保留成 Markdown,AI 直接读,直接干活。
支持 Reasonix / Cursor / Claude Code / Codex 等 AI 编程工具。
安装
bash
git clone https://gitee.com/seashoreman/docx2md-skill
pip install python-docx
按你用的平台安装:
| 平台 | 命令 |
|---|---|
| Reasonix | cp docx2md-skill/docx2md.md .reasonix/skills/ |
| Cursor | cp -r docx2md-skill/cursor/.cursor . |
| Claude Code | cp -r docx2md-skill/claude/.claude . |
或全局安装(本机所有项目可用):
bash
cp docx2md-skill/docx2md.md ~/.reasonix/skills/
使用
在 AI 对话里直接说:
「帮我把 需求文档.docx 转成 md」
转换完之后:
markdown
需求文档/
├── 需求文档.md ← 排版完整的 Markdown
└── images/
├── image_1.png ← 文档里所有图片都提出来了
└── image_2.jpg
一个文件夹全拿走,去任何 Markdown 编辑器、GitHub、语雀都能直接用。
进阶用法
| 场景 | 操作 |
|---|---|
| Word 需求给 AI | .docx → .md → 发给 AI → 出方案、写代码 |
| Word 转博客 | 写完的稿子一键 md,发 GitHub Pages |
| 文档归档 | 转成 md 放项目 docs/,git 管理版本 |
| 批量转换 | 写个 for 循环,50 个 Word 一起转 |
原理
用 python-docx 解析 Word 的 XML 结构,提取段落、标题、列表、表格、图片,拼成标准 Markdown。全程本地运行,不依赖任何外部服务,断网也能用。
适合谁
- 经常跟 Word 打交道的人(产品、项目经理、编辑)
- 想用 AI 处理 Word 需求的开发者
- 做文档迁移、技术写作的人