用途:把 Markdown(.md)文件转换为格式专业的 Word(.docx)文档,并内嵌 PNG 图片。实现基于 docx 与 marked 两个 npm 包,纯 JavaScript,无需 Pandoc、LibreOffice 或任何原生二进制。
主要能力:提取 YAML front-matter 中的 title、date、version、audience 生成标题页;根据 H1-H3 标题生成目录;解析 图片引用(相对输入 .md 文件路径),读取 PNG 并从文件头提取尺寸,按保持宽高比缩放至 6 英寸宽内嵌;输出使用 Calibri 字体、#1F3864 彩色标题、交替行色表格、Consolas 代码块;支持标题、段落、表格、代码块、列表、图片、链接、水平线等 Markdown 元素。图片缺失时插入占位符 [Image not found: <path>]。
使用方式:先在 scripts 目录一次性安装依赖,再从工作区根目录运行转换命令。 cd skills/md-to-docx/scripts && npm install node skills/md-to-docx/scripts/md-to-docx.mjs <input.md> [output.docx] 省略 output.docx 时,默认在当前目录生成与输入同名的 .docx。
前置要求:Node.js 18+;docx 9+;marked 15+。无原生二进制、无系统级安装,支持 Windows、macOS、Linux。
front-matter 格式示例:
title: Project Name — Project Summary date: 2025-01-15 version: 1.0 audience: Engineering Team, Architects, Stakeholders
标题会按 — 或 – 拆分为主标题与副标题用于标题页。
限制:仅内嵌 PNG 图片;其他格式、收费与价格、平台细节等资料暂未提供。