用途:把任意 Markdown 文档(含复杂 Mermaid 图)一键转换为排版专业的 Word(.docx)文件,适合交付给利益相关者、管理层和外部读者。
主要能力:预处理 Markdown,修复项目符号列表、复选框语法与间距;将 Mermaid 图渲染为白底 PNG 并读取实际尺寸,按页面 90%(横向与纵向)约束自动计算最优尺寸;将 SVG 横幅转为 PNG;通过 pandoc 生成 docx;为表格应用 Microsoft 蓝色表头(#0078D4)、边框与隔行底色,并采用 cantSplit 与 keepWithNext 智能分页防止表头孤立;图片居中,标题样式统一;支持甘特图、流程图、时序图、类图、ER 图、饼图等,按宽或高优先策略选尺寸。
使用方式:需 Python 3.10+、pandoc、mermaid-cli、python-docx 及可选的 svgexport。示例命令:winget install pandoc;npm install -g @mermaid-js/mermaid-cli svgexport;pip install python-docx。运行:python .github/muscles/md-to-word.py docs/spec.md,可指定输出名或使用 --keep-temp、--images-dir、--no-format-tables 等选项。
适用场景:技术文档、方案与规范交付、对外演示材料。
限制:依赖上述外部工具,缺少时需按提示安装;部分参数与版本行为以实际脚本为准,其他细节暂未提供。