Markdown 转 DOCX Skill | 模板驱动 Word 导出工具下载

工具简介

这是一个面向 AI Agent 和内容工作流的开源 Skill，用来把 Markdown 文本稳定导出成排版质量更高的 .docx 文档，而不是只做最基础的 Pandoc 一键转换。

它的核心价值不只是“能转”，而是能把输出结果交给 Word 模板体系来控制。你可以直接复用已有的 .docx 或 .dotx 模板样式，让最终文档尽可能贴近出版社、企业模板、课程讲义、行业报告或内部交付规范。

如果你的原始内容来自 Obsidian、知识库笔记、长文草稿、研究报告或带 Mermaid 图表的 Markdown，这个 Skill 会比裸 Pandoc 更适合正式交付场景。

核心能力

模板驱动排版

• 支持使用任意 .docx / .dotx 模板控制输出样式
• 通过 Lua filter 和后处理脚本，把段落、标题、图注、表注、代码块等映射到模板样式
• 适合需要“统一出版社模板”或“复用公司 Word 样式规范”的场景

更适合 Obsidian 和内容创作流程

• 自动兼容 Obsidian 图片嵌入语法，例如 ![[image.png]]
• 自动扩大 resource-path，减少图片资源丢失
• 支持把顶层目录中的多篇 Markdown 批量导出成多个 DOCX

不只是转换，还带质量修复

• 自动修正常见的图注、表注缺失问题
• 自动处理图注与图片黏连、标题编号冲突、列表缩进、代码样式、表格边框等问题
• 内置导出后校验，帮助你发现样式异常，而不是到 Word 里手工排雷

支持 Mermaid 图表

• 在可用的 Node.js / npx 环境下，可以把 Mermaid 代码块渲染成 PNG 再写入 DOCX
• 对需要保留流程图、系统图、信息结构图的技术文档尤其有用

包含内容

这个 ZIP 里主要包含：

• SKILL.md：完整使用说明
• scripts/convert_markdown_to_docx.sh：基础 Markdown -> DOCX 转换脚本
• scripts/render_markdown_with_dotx.sh：带 Word 模板渲染的主流程脚本
• scripts/template_style_filter.lua：样式映射过滤器
• scripts/postprocess_template_docx.py：模板后处理脚本
• scripts/validate_captions.py：图表注释与导出结果校验工具
• scripts/render_mermaid_blocks_for_docx.py：Mermaid 渲染脚本
• references/editorial-template-rules.md：排版规范参考

适用人群

• 需要把 Markdown 手稿交付成正式 Word 文档的内容团队
• 用 Obsidian 写长文、课程、研究报告、行业分析的人
• 想把 AI 生成内容纳入标准化 DOCX 交付流程的开发者
• 需要复用出版社、公司、机构既有 Word 模板样式的人
• 想做“Markdown 为源，DOCX 为交付物”的自动化工作流的人

为什么值得下

很多 Markdown 转 Word 的方案，最大问题不是“转不出来”，而是转出来之后还得重新排版。

这个 Skill 的价值在于，它把“Markdown 内容生产”和“模板控制下的 DOCX 交付”连成了一个更完整的流程：

• 前端内容继续用 Markdown 写，方便 AI、知识库和自动化处理
• 最终交付仍然是更通用的 .docx
• 版式、标题层级、列表、图表标题、表格边框等细节可以被模板和脚本共同约束

如果你已经有一套现成的 Word 模板，希望以后所有 Markdown 内容都按那套模板稳定出稿，这个资源会非常实用。