Word 转 Markdown，一行命令搞定——AI 技能「docx2md」使用指南

痛点

客户 / 同事发来 Word 需求文档，想丢给 AI 分析、出方案、写代码。但 AI 读不了 .docx，你得先手动转成纯文本，排版还乱了。

解决方案

docx2md — 把 .docx / .doc 一键转成 Markdown，图片自动提取，排版不丢。

效果：标题、列表、加粗斜体、表格、图片……完整保留成 Markdown，AI 直接读，直接干活。

支持 Reasonix / Cursor / Claude Code / Codex 等 AI 编程工具。

安装

git clone 
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 .

或全局安装（本机所有项目可用）：

cp docx2md-skill/docx2md.md ~/.reasonix/skills/

使用

在 AI 对话里直接说：

转换完之后：

需求文档/
├── 需求文档.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 需求的开发者
• 做文档迁移、技术写作的人

链接

• 技能仓库：gitee.com/seashoreman…