md-to-word 的核心用途是把 Markdown 转换为排版规范的 Word 文档。它自动将 Mermaid 图表渲染为高分辨率 PNG(约 4 倍缩放),将 SVG 插图转换为 PNG 并嵌入,支持全部标准 Markdown 格式,包括标题、加粗斜体删除线、嵌套列表、任务列表、表格、代码块、内联代码、链接、图片、引用、分隔线等,脚注经 pandoc 支持,YAML frontmatter 可用 --strip-frontmatter 去除。
主要能力包括:表格采用微软品牌样式(蓝色表头、边框、斑马纹),并防止行跨页断裂、长表自动重复表头;标题分级配色;代码块使用 Consolas 字体与浅灰背景;链接显示为蓝色下划线;按页面比例(宽约 90%、高约 60%)自动缩放图片,避免溢出;内置 professional、academic、course、creative 四种样式预设。
使用方式:安装 Node.js 18+、pandoc、mermaid-cli 与 svgexport 后,运行 node .github/skills/md-to-word/scripts/md-to-word.cjs docs/spec.md,可加 --toc、--cover、--style、--page-size、--reference-doc、--watch、--recursive、--dry-run 等选项;支持批处理与 GitHub Actions 集成。
限制:需自行安装外部依赖;图片按固定比例适配 Letter/A4 等页面;macOS 无 pandoc 时可用 textutil 回退,但表格样式与图片尺寸能力受限;该工具是否能保证往返编辑后格式不丢失尚未验证。部分细节暂未提供。