docx2md 使用指南：一行命令将Word转为Markdown
Word 转 Markdown 一行命令搞定：AI 技能「docx2md」全流程指南
日常协作中，客户或同事发来一份 .docx 需求文档，想直接扔给 AI 分析、生成方案甚至写代码，结果 AI 不识别 Word 格式。只能手动复制粘贴纯文本，排版碎一地，图片还得一张张另存。这种重复劳动，早点优化掉。
解决方案
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 需求的开发者
- 从事文档迁移、技术写作的团队或个人