Gotenberg Client

Go client for Gotenberg — document conversion service supporting Chromium, LibreOffice, and PDF manipulation engines.

go get github.com/nativebpm/gotenberg

Features

• Chromium: Convert URLs, HTML, and Markdown to PDF
• LibreOffice: Convert Office documents (Word, Excel, PowerPoint) to PDF
• PDF Engines: Merge, split, and manipulate PDFs
• Webhook support: Async conversions with callback URLs
• Stream-first: Built on httpstream for efficient multipart uploads

Conversion Engines

Chromium

Convert web content to PDF:

• URL → PDF
• HTML file → PDF
• Markdown → PDF

Supports:

• Custom page properties (size, margins, orientation)
• Headers & footers with page numbers
• Wait strategies (delay, JavaScript expression)
• Cookies & custom HTTP headers
• Emulated media types (screen/print)

LibreOffice

Convert Office documents:

• Word (.docx, .doc) → PDF
• Excel (.xlsx, .xls) → PDF
• PowerPoint (.pptx, .ppt) → PDF
• OpenDocument formats → PDF

PDF Engines

PDF operations:

• Merge multiple PDFs
• Split pages
• Convert images to PDF

Webhook Mode

Async conversions with callbacks:

• Returns 204 No Content immediately
• Uploads result to webhook URL in background
• Separate error callback URL
• Custom HTTP headers for callbacks

See Gotenberg webhook docs for details.

Examples

• Chromium: URL to PDF
• Chromium: Hello World
• Chromium: Markdown to PDF
• Chromium: Timeout handling
• Chromium: Trace header
• Chromium: Webhook async
• LibreOffice: Document conversion
• PDF Engines: Merge PDFs
• Health check

License

MIT — see LICENSE.