用途:把 Markdown 文档一键转换为排版规范的 Word(.docx)文件,适合规格说明、报告、论文、课程材料等正式交付场景。
主要能力:支持标准 Markdown 格式(标题、列表、任务列表、表格、代码块、链接、图片、引用、脚注等);Mermaid 图表自动渲染为高分辨率 PNG 并按页面尺寸适配;SVG 插图自动转 PNG 嵌入;表格应用 Microsoft 蓝色表头、边框与斑马纹,并支持跨页不拆行、表头重复;代码块使用 Consolas 字体与灰色背景;标题、超链接、页码、图注统一美化。提供 professional、academic、course、creative 四种样式预设,以及 --toc、--cover、--page-size、--reference-doc、--watch、--recursive、--dry-run、--debug 等选项。
使用方式:需先安装 Node.js 18+、pandoc、mermaid-cli,SVG 转换可选安装 svgexport。基本命令:node .github/muscles/md-to-word.cjs docs/spec.md;可加自定义输出名、--style academic --toc、--cover 等参数。支持批量与递归处理目录,也可在 GitHub Actions 或 npm scripts 中调用。
限制:依赖外部工具链,缺少 pandoc、mermaid-cli 或 svgexport 会报错;macOS 无 pandoc 时可用 textutil 回退,但表格样式、图片尺寸与交叉引用支持有限;SVG 源建议使用 viewBox、内嵌字体、小于 500KB 且避免外部引用;复杂图表可能溢出,需用 --debug 检查。具体收费、平台与效果资料未提供。