boxpdf

boxpdf 是一款轻量级 PDF 布局引擎，专为 Node.js、Cloudflare Workers、Deno、Bun、Supabase Edge 及浏览器等 JavaScript 运行时设计。它基于 pdf-lib 构建，提供类似 Flexbox 的布局 DSL，让开发者能够以声明式的方式生成结构化的 PDF 文档，无需依赖 Chromium 或动态 WASM。

核心功能

• Flexbox 布局：使用熟悉的 CSS Flexbox 模型，轻松控制元素排列、对齐与分布。
• 多运行时支持：完美适配 Node、Deno、Bun、Cloudflare Workers 等边缘环境，实现无头浏览器替代方案。
• HTML/CSS 渲染：通过 boxpdf-html 子模块，在无法运行 Chromium 的环境中实现像素级 HTML/CSS 渲染。
• 丰富排版特性：支持分页、自动换行、间距控制、页眉页脚、图片、链接、表格及可复用模板。

主要特性

• 零依赖 Chromium：无需安装 Chrome 或 Puppeteer，适合 Serverless 和边缘部署。
• 高性能与轻量：代码体积小，运行速度快，特别适合高并发场景。
• 灵活模板系统：支持组件化设计，可复用布局模板，提升开发效率。
• 原生分页支持：自动处理内容分页，支持自定义页眉页脚。
• 跨平台一致性：在不同运行时环境下输出效果一致。

适用场景

• Serverless 函数：在 Cloudflare Workers 或 AWS Lambda 中动态生成发票、报告。
• 边缘计算：在 Supabase Edge 或 Deno Deploy 上即时生成 PDF。
• 浏览器端：无需后端服务，直接在浏览器中创建和下载 PDF。
• 自动化文档：批量生成合同、证书、表单等结构化文档。