api.chromiumly.dev with an API key, or run Gotenberg yourself (self-hosted).
What you can do
- Chromium: Convert URLs, HTML, and Markdown to PDF; capture full-page screenshots as PNG, JPEG, or WebP.
- LibreOffice: Convert DOCX, XLSX, PPTX, and other office formats to PDF.
- PDF engines: Convert to PDF/A and PDF/UA, merge PDFs, read/write metadata, split, flatten, and more.
Hosted API vs self-hosted
| Option | Use when |
|---|---|
| Hosted API | Recommended. No Docker or server management. Set CHROMIUMLY_API_KEY or call Chromiumly.configure({ apiKey: "..." }). Requests go to https://api.chromiumly.dev. |
| Self-hosted | You run Gotenberg (e.g. via Docker). Set GOTENBERG_ENDPOINT or call Chromiumly.configure({ endpoint: "http://localhost:3000" }). |
Quickstart
Install the package and run a minimal URL-to-PDF conversion.
Configuration
Configure the endpoint or API key (hosted vs self-hosted).
Chromium
Convert URLs, HTML, and Markdown to PDF; capture screenshots.
LibreOffice
Convert office documents (DOCX, XLSX, PPTX, etc.) to PDF.
PDF engines
Merge, split, flatten, and convert to PDF/A or PDF/UA.
SDK reference
The library exports converters, screenshot classes,LibreOffice, and PDFEngines. See the Reference tab for class and type details.