用途:把 Markdown 转换为 PDF、PNG 或 JPEG。渲染管线为 Markdown 经 markdown-it 及插件生成内嵌 CSS、数学公式和图表的独立 HTML,再由 Puppeteer 启动无头 Chrome 加载并导出:page.pdf() 输出 PDF,page.screenshot() 输出 PNG 或 JPEG。
主要能力:支持数学公式(markdown-it-texmath + KaTeX)、语法高亮、目录、脚注;可配置纸张格式(A3/A4/A5/Letter/Legal/Tabloid)、横竖方向、边距、背景打印、页眉页脚、截图宽度与缩放、JPEG 质量、CSS 主题(github、github-dark、minimal)。
使用方式:先运行 bash skills/md2pdf-export/scripts/setup-env.sh 检查并安装环境(幂等,可重复运行),或手动安装 Node.js ≥ 18 与 puppeteer。转换命令示例:node skills/md2pdf-export/scripts/md2pdf.js input.md;加 --type png 或 --type jpeg --quality 90;用 -o 指定输出;用 --format A3 --landscape 设置纸张。可在 Markdown 的 YAML front-matter 中写 puppeteer、screenshot、export_on_save 配置。也可在 Node.js 中调用 convertMarkdown() 集成到流水线。
适用场景:文档、论文、报告等 Markdown 批量导出,支持目录批量转换。
限制:依赖 Chrome/Chromium 与系统字体,CJK 字体缺失需另装;Linux 容器可能需 --no-sandbox;异步内容(如 Mermaid)需增加 --wait;具体收费、价格与平台支持资料暂未提供。