核心用法
PDF Generator 是一套本地化的 PDF 生成解决方案，支持从多种源格式创建专业文档。根据输入类型选择最佳工具链：Markdown 推荐 pandoc+LaTeX，HTML/CSS 首选 weasyprint（默认方案），数据/JSON 使用 reportlab，简单文本可用 fpdf2，截图场景则采用 playwright。
显著优点
- 本地化优先：所有生成过程均在本地完成，无需 API 密钥，不依赖外部服务
- 工具链灵活：针对不同场景提供最优解，weasyprint 的 CSS 支持尤为出色，无需配置 LaTeX
- 专业级排版：内置打印优化 CSS、分页控制、元数据管理，确保输出符合商业标准
- 全格式覆盖：从纯文本到富媒体内容，覆盖报告、发票、合同等常见文档类型
潜在缺点与局限性
- 环境依赖：需手动安装多组工具链（pandoc、LaTeX、Python 库等），新手配置成本较高
- 字体管理：跨平台字体渲染可能存在差异，需显式嵌入或选用 Web 安全字体
- 性能边界：批量处理大型文档或复杂 CSS 动画时，生成效率受限
- 无协同功能：纯生成工具，不支持多人协作编辑或云端模板共享
适合人群
- 开发者、技术写作者、小型团队及隐私敏感用户
- 需要自动化生成发票、合同、报告的业务场景
- 希望避免订阅制 SaaS 工具、追求数据本地化的组织
常规风险
- 字体缺失导致排版降级，需预检字体嵌入状态
- 绝对路径图片可能丢失，建议使用相对路径或 base64 内嵌
- 未指定页码引发打印错乱，必须显式声明
@page规则 - 大图片未压缩造成文件膨胀，需在嵌入前预处理
- Unicode 编码处理不当导致乱码，全程保持 UTF-8
生成后务必执行 pdfinfo 验证：检查文件大小（排除 0 字节失败）、页数、嵌入资源完整性，并在目标平台实测。