SuperAPI AI 工具集

md-to-word

办公与效率

查看项目

更新于 10-15 21:40

技能介绍

用途:把 Markdown 文档(包括复杂的 Mermaid 图表)转换为排版整洁的 Word(.docx)文件,便于交付给管理层或外部读者。该技能只负责转换这一步,后续在 Word 中手动微调并另存为 PDF 由用户自行完成。

主要能力:预处理 Markdown(修复项目符号、复选框语法与间距);将 Mermaid 渲染为白底 PNG;读取 PNG 实际尺寸并按页面 90% 范围计算最优缩放;将 SVG 横幅转为 PNG;通过 pandoc 生成 docx;为表格套用微软蓝表头、边框与隔行底色;图片居中;统一标题样式;表格分页时避免行被拆分、表头与数据分离。

使用方式:在项目根目录运行 node .github/muscles/md-to-word.cjs docs/spec.md,可指定输出名或加 --keep-temp 保留中间文件。选项包括 --images-dir(默认 images)、--no-format-tables、--keep-temp。依赖 Node.js 18+、pandoc、mermaid-cli,可选 svgexport;安装命令如 winget install pandoc、npm install -g @mermaid-js/mermaid-cli svgexport。

适用场景:需要将含甘特图、流程图、时序图等技术文档转为正式 Word 交付物的场合。

限制:仅完成 Markdown 到 Word 的转换,PDF 导出需手动;表格样式依赖 jszip 与 NODE_PATH;部分图表类型按宽度或高度优先,具体尺寸策略见资料;未提供收费、平台支持范围等信息。