（9945期）Pdf Generator – 专业 PDF 生成代码模式库

专业 PDF 生成代码模式库 PDF 生成指南：提供 Markdown、HTML、JSON 等数据源的 PDF 生成代码模式与最佳实践，涵盖工具选型、CSS 打印样式与文档结构优化。 使用说明 核心用法 PDF Generator 是一个参考型技能，专注于为开发者提供 PDF 文档生成的完整代码模式与实施指南。该 skill 不直接执行代码或生成文件，而是通过系统化的文档结构，帮助用户根据不同数据源选择最优工具链： Markdown → PDF：推荐使用 Pandoc，原生支持目录生成与模板系统 HTML/CSS → PDF：WeasyPrint 为首选，提供最佳的 CSS 打印媒体支持，无需 LaTeX 依赖 数据/JSON → PDF：ReportLab 适合程序化生成，提供像素级精确控制 简单文本：fpdf2 轻量快速 关键实施原则 结构优先于样式：使用语义化 HTML（<article>, <header>, <section>）而非内联样式 显式控制分页：通过 CSS page-break-before, page-break-inside: avoid 等属性防止内容断裂 强制设置元数据：文档标题、作者信息必须在 <head> 中声明 打印优化 CSS：利用 @media print 和 @page 规则控制页面尺寸（A4）、边距（2cm）及字体选择 输出验证三步骤：检查文件大小（0 字节 = 失败）、页数、字体渲染 显著优点 工具选型矩阵清晰：根据输入类型直接映射到最佳工具，降低决策成本 防踩坑指南完备：针对缺失字体、绝对路径图片、未设置页面尺寸等常见问题提供明确解决方案 零外部依赖：纯本地代码模式，不发送数据至外部服务 多平台支持：覆盖 Linux、macOS、Windows 潜在局限 非执行型 skill：仅提供参考代码，用户需自行集成到项目 无模板库：templates.md 等文件仅为引用说明，未提供现成模板 高级功能受限：水印、数字签名、PDF/A 合规等进阶需求需用户自行探索 适合人群 后端开发者、数据工程师、需要程序化生成报告/发票/合同的技术团队，以及希望将文档工作流自动化的 DevOps 人员。 常规风险 字体版权问题：商业字体嵌入需确认授权 图片路径陷阱：绝对路径在跨环境部署时失效 大文件生成：未压缩图片导致 PDF 体积异常 原始说明 Generate professional PDFs from Markdown, HTML, data, or code. Reports, invoices, contracts, and documents with best practices.