md-pdf-render Skill

将 Markdown 文件转换为 PDF，渲染效果与编辑器 Markdown 预览完全一致。

核心能力：

使用方法

第一步 —— 确认依赖

脚本位于 skill 的 scripts/ 目录，首次使用需安装依赖：

cd <skill-path>/scripts && npm install

需要系统安装 Chromium（Puppeteer 会自动下载）。

第二步 —— 执行转换

node <skill-path>/scripts/md-pdf-render.mjs <输入文件.md> [输出文件.pdf] [选项]

选项：

第三步 —— 验证输出

用 open <output.pdf>（macOS）或 xdg-open（Linux）打开确认效果。

示例

基本转换

node md-pdf-render.mjs README.md
# 输出: README.pdf (GitHub 风格)

暗色主题 + 目录

node md-pdf-render.mjs docs/guide.md guide.pdf --theme vscode --toc

自定义样式 + Letter 纸张

node md-pdf-render.mjs report.md --css brand.css --format Letter --margin 20mm

批量转换（配合 shell）

for f in docs/*.md; do
  node md-pdf-render.mjs "$f"
done

自定义 CSS

创建 CSS 文件覆盖默认样式：

/* brand.css — 自定义品牌风格 */
:root {
  --color-fg: #333;
  --color-link: #e63946;
  --font-body: "Noto Sans SC", sans-serif;
}
h1 { color: #1d3557; }
pre { border: 1px solid #ddd; }

通过 --css brand.css 加载。

工作原理

Markdown 文件
    ↓ markdown-it (GFM 解析)
HTML + highlight.js 代码高亮
    ↓ 注入主题 CSS
完整 HTML 页面
    ↓ Puppeteer (Chromium 无头浏览器)
高保真 PDF

使用 Puppeteer 调用 Chromium 渲染引擎，确保与浏览器/编辑器预览效果完全一致。

常见问题