Word 转 Markdown：DOCX 转换工作流与校验清单

如果你需要可搜索文本、供总结的可审阅来源，或轻量化地批量比较文档，可以生成 Markdown 副本。它是工作用文本表示，不是 Word 原文件的替代品。

如果验收依赖精确分页、视觉版式、签名、批注或修订记录，请保留 DOCX，并在 Word 或渲染后的 PDF 中检查。Markdown 看起来整齐，不代表 Word 的每项功能都保留了。

这里介绍的 convert-word-to-md 是 GitHub Copilot Agent Skill，不是浏览器上传转换服务。安装前先看它的资料页，并使用适用于对应平台的安装命令。

确认每个输入都是 .docx。固定版本不处理旧式 .doc；请先另存为 DOCX。文件夹里若混有 PDF 或工作簿，也要单独安排处理流程——Word 脚本会有意跳过其他文件类型。

脚本会创建 Markdown 与图片副本。请确认当前 Agent 环境获准处理这些文档，并按原文件的信息级别保护输出目录。

• 批量转换前，先列出输入文件和格式。
• 确定输出位置；默认会在每个源文件旁创建目录。
• 如果需要保留之前手动编辑的 Markdown，请使用新的输出位置。

上游配置要求 Python 3.10 或更新版本、pip 和 MarkItDown 的 DOCX 依赖。请在 Skill 目录下完成配置，并在实际运行转换脚本的同一 Python 环境中验证导入。requirements 文件只规定最低版本，没有锁定唯一版本。

以下命令用于准备转换依赖，并不会安装 Agent Skill。GitHub Copilot 的 Skill 安装命令请到资料页复制。

在 Skill 目录下运行随附脚本，并把示例路径替换成真实输入路径。单文件默认生成同名目录；递归模式会查找子目录中的 DOCX，并在指定的批处理目标位置保留相对目录结构。

文档含嵌入图片时，脚本会在 img/ 中生成图片文件，并由 Markdown 使用相对路径引用。移动或分享时要带上整个输出目录，不能只拿走 .md 文件。

• 第一条命令使用源文件旁的默认输出位置。
• 只有确实要另存到其他位置时才使用 -o；运行前检查该目标目录。
• 批处理结果若有失败，应逐项处理，不要把部分成功当成全部完成。

转换只是准备工作，不是内容解读。让 Agent 总结、比较或提取重要信息之前，先把输出与原件对照检查。

• 检查标题顺序、段落顺序、列表，以及表格标题和关键数值。
• 逐一打开相对图片链接，确认提取图片对应文档中的正确位置。
• 回到原文件检查页眉页脚、脚注、批注、修订、分页和复杂版式；小样本检查没有验证这些内容。
• 确认输出目录只包含你打算保留或分享的文件。

源码检查发现，固定版本脚本会在写入前删除已经存在的目标目录。这可能连同手工编辑过的 Markdown 或同目录其他文件一起移除。SkillSignal 的样本检查没有实际测试删除行为；重新运行前请备份旧结果或选择新的输出目录。

这是源码审阅发现，不代表 SkillSignal 实际执行过破坏性删除。对真实文件运行前，应阅读实现并再次确认目标位置。

SkillSignal 于 2026 年 10 月 14 日使用两份虚构 DOCX 和 MarkItDown 0.1.8 运行了固定版本 Python 脚本。样本核对了部分标题、列表文字、两个表格数值、图片顺序与文件内容、纯文本文件，以及源文件校验值未变化。

它没有测试 GitHub Copilot 加载、安装、递归目录、复杂表格、分页、批注、修订、受保护文件、客户文档或安全性；这不是基准测试，也不保证任意文档都能准确转换。上游要求为 markitdown[docx]>=0.1.0，因此新环境可能安装不同版本。