用途:将带 YAML frontmatter 的 Markdown 文档转换为带样式、适合打印的 PDF,基于 Chrome headless,无需手写 HTML。适合专业报告(GTM 策略、提案、工程摘要)等需要封面、章节标题和打印优化版式的文档。
主要能力:支持自动生成封面页(来自 frontmatter,如 title、subtitle、date、author、version、confidentiality、accent_color、footer,均为可选,title 默认 Untitled Document);提供组件样式,如 section-header、card、tier-header、score-chip、priority-badge、summary-grid/metric-card;标准 Markdown 表格、引用、代码块、标题自动样式化;支持分页控制(page-break、avoid-break)与模板选择。
使用方式:python3 .claude/skills/data/documents/md-to-pdf/md_to_pdf.py document.md -o output.pdf。CLI 参数包括 -o/--output、--screenshot、--no-cover、--keep-html、--template(默认 base)。
依赖与限制:需要 Chrome(/usr/bin/google-chrome,建议 v145+)、Python 3.10+ 及 markdown 库(v3.5.2+,含 tables、fenced_code、toc、attr_list、meta、sane_lists)。脚本使用 Chrome headless 参数,如 --no-sandbox、--disable-gpu、--print-background 等;开发时建议用 --screenshot 做视觉 QA。常见问题包括 Chrome 未找到导致空白 PDF、缺少 --print-background 导致无背景色、大表格跨页需用 avoid-break 包裹、accent_color 拼写错误、--no-cover 导致封面缺失。