带 Mermaid 的 Markdown 转 docx

一般来说，LLM 都只能生成纯文本，如果要格式，一般只能 Markdown，并不能直接编辑 Word 文档（当然有一些 MCP 服务可以实现，没体验过）。另一方面，要让 LLM 来画图，在不使用 MCP 的情况下，也只有 Mermaid 能画。

本文主要提出一种「LLM 原生」、带 Mermaid 的 Markdown 转换成 Word 文档（docx）的方法，适用于软著之类很适合用 AI 去编写的文档。

第一步当然是用任意 AI 去给你生成一份带 Mermaid 的 Markdown 文档，直接在 prompt 里面要求它用 Mermaid 来画流程图/架构图之类就行。这时候你会得到一份原始的 Markdown 文档，里面的 Mermaid 是纯文本，还不是图片。

第二步用 mermaid-cli 把文档里面的 Mermaid 片段全部找出来，渲染成图片，然后把片段替换成图片引用。一条命令就能搞定：

npx -p @mermaid-js/mermaid-cli mmdc -i doc.md -o doc_mermaid.md -e png

这里如果不加 -e png 会默认生成 svg 格式，理论上更好，只是不知道为什么在 Word 里展示异常。

最后就是去生成 Word 文档，也有对应的工具。

pandoc doc_mermaid.md -o doc.docx --toc --toc-depth=3

--toc 会在文件前面生成一个目录，按需使用即可。

References