用途:把 Markdown 文档转换为符合中文排版标准的专业 Word 文档,适用于正式文档、论文、报告、书籍等需要规范排版的转换场景。
主要能力:支持完整 Markdown 语法并自动套用专业格式;提供多种内置预设(legal 默认法律文书、service-plan、minimal、academic、report、book-publish 书籍出版),可用 python scripts/config.py --list 查看完整列表;支持 --config 自定义 YAML 配置,assets/templates/ 或 --template 指定 Word 模板控制页眉页脚等视觉元素。支持脚注/尾注(--notes=endnote)、全书合并(--book 多章合并为单 docx,生成目录、分章、页眉)、Mermaid 图表、内联 SVG 渲染为 PNG、Markdown/HTML 表格与图片处理。
使用方式:先安装依赖 pip install python-docx Pillow beautifulsoup4 PyYAML;可选 npm install -g @mermaid-js/mermaid-cli 等。基本转换 python scripts/md2word.py input.md output.docx;使用预设 python scripts/md2word.py input.md --preset=academic;自定义配置加 --config=my-config.yaml;全书合并 python scripts/md2word.py --book ch01.md ch02.md ch03.md -o book.docx --preset=book-publish。自动检测 UTF-8 与 GBK 编码。
限制与安全:转换会调用本地脚本与外部渲染工具,并默认向 Markdown 中的外部图片 URL 发起网络请求(仅拉取图片,不上传文档内容),处理不可信 Markdown 可能带来 SSRF 或恶意图片风险,建议只转换可信来源文档。渲染优先级 rsvg-convert → cairosvg → svg2png.js,全部不可用时 SVG 降级为代码框;Mermaid 失败降级为文本描述;模板找不到时使用默认格式。价格与收费信息暂未提供。