Markdown 转 Word 图片工具

问题

把 Markdown 导出成 Word 时，常见麻烦不是“能不能生成 .docx”，而是图片没有嵌入、标题没有映射成 Word heading 样式、表格格式漂移，图片说明还停留在正文段落样式里。手动调用 pandoc 可以完成转换，但需要先确认依赖、检查相对图片路径，再补一次 caption 修正，步骤很容易遗漏。

工作方式

这个技能把转换流程拆成几个明确环节：以 pandoc 作为转换核心，用 scripts/check_images.py 在转换前校验所有图片引用是否指向真实文件；随后调用 scripts/md_to_docx.py 完成 .md 到 .docx 的转换，并自动处理图片说明，使其居中、8pt、非斜体。若环境中缺少 pandoc，它会尝试自动安装并提醒刷新终端；如果走手动 pandoc 路径，也可以用 scripts/fix_captions.py 事后修复已有文档中的 caption。

• 图片嵌入：支持本地相对路径和远程 URL，并在转换前检查路径有效性
• 样式保留：Markdown 标题映射为 Word heading 样式，粗体、斜体基本保留
• 参考文档：可用 --reference-doc 控制标题字体、表格样式、页边距等
• caption 规范化：把 Pandoc 默认生成的普通段落说明改成更接近图表说明的格式

边界

它不是纯 Python 文档生成器，核心依赖 pandoc。复杂 Word 表格如果经历 docx -> md -> docx 往返，合并单元格、嵌套表格等结构可能丢失；目录也可能从 Word TOC 降级为普通链接或文本。.emf 图片可以嵌入，但跨系统显示不一定稳定。它更适合把结构相对规整、图片路径清晰的 Markdown 文档导出成可分发的 Word 文件。