用途:把 Markdown 文件转换为排版专业的 PDF,完整渲染 Mermaid 图表、LaTeX 数学公式(经 KaTeX)、表格、语法高亮代码块及标准 Markdown 特性。
主要能力:Mermaid 图表(flowchart、sequence、class、state、ER、gantt、pie、git、mindmap 等)经 mmdc 渲染为 SVG;行内与显示 LaTeX 数学公式经 KaTeX 服务端渲染;GFM 管道表格、代码高亮、本地与远程图片、链接、列表、引用、YAML frontmatter、脚注、定义列表、删除线、水平线。
使用方式:先运行 bash <SKILL_DIR>/scripts/setup.sh 检查依赖。基本命令:python3 <SKILL_DIR>/scripts/md_to_pdf.py <input.md> <output.pdf>。可选参数包括 --format(A4/Letter/Legal/A3)、--margin、--no-mermaid、--no-math、--css、--landscape、--header-footer。依赖 pandoc、@mermaid-js/mermaid-cli、katex、playwright(含 chromium)。
适用场景:需要将技术文档、报告等 Markdown 转为带图表与公式的 PDF。
限制:Mermaid 渲染需网络或本地安装;超大文档可能触及 Playwright 内存上限,需拆分;自定义 CSS 在不同 PDF 阅读器中显示可能不一致;分页需显式 CSS 标记;KaTeX 覆盖不完整,冷门宏会回退为原始 LaTeX。