Markdown 与 Word 双向转换

解决什么问题

在文档协作中，Markdown 适合版本管理和轻量写作，Word 更适合正式交付、批注和排版。手工复制粘贴时，标题层级、代码块、表格、图片、Mermaid 图表和合并单元格很容易丢失或错位。md2docx 面向这个问题，提供 .md 与 .docx 之间的双向转换，并按文件扩展名自动判断转换方向。

技能如何工作

• MD 到 DOCX：输出 Word 文档时会处理中文排版，正文使用微软雅黑、10.5pt，表格使用 9pt；标题按层级自动放大，末级约 12.5pt，每升一级增加 2pt。代码块会显示为灰色背景、四边框和 Consolas 等宽字体；**粗体**、*斜体*、行内代码、链接、引用块、分割线、图片等常见结构也会被保留。
• 表格与合并单元格：Markdown 原生表格不支持 rowspan / colspan，因此技能采用 HTML 嵌入方案。MD 中的 HTML 表格可以被主流渲染器显示，转回 DOCX 或解析 DOCX 时也能尽量还原合并结构。
• 图表与依赖：Mermaid 代码可渲染为 PNG 嵌入 Word，脚本会自动检测系统 Chrome、Edge 或 Chromium；若环境缺少 Node.js、python-docx、mammoth、beautifulsoup4 等依赖，相关能力会缺失或降级，例如 Mermaid 可能变成文字占位，代码高亮回退为纯文本。

适用边界

适合个人文档、技术说明、报告草稿和 Office 交付前的格式转换。它不是完整排版引擎：复杂 Word 样式、页眉页脚、域代码、公式等未列出的特性可能无法精确保留。若文档包含大量合并单元格，应优先使用 HTML 表格表达；若只需要普通文本转换，可忽略 Node 和 Mermaid 相关依赖。