HTML to PDF in Go

Updated July 2026 · HTTP client: net/http — standard library only

The shortest reliable path from HTML to PDF in Go is not a rendering library — it’s an HTTP call to a rendering API. Your app sends HTML, a managed Chromium engine renders it exactly as Chrome would, and a PDF comes back. No browser binaries in your deploy, no native dependencies, no page-break surprises.

Complete example (main.go)

Set NIPPYPDF_API_KEY in your environment, then this is the whole program:

// main.go — run with: go run main.go
package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io"
	"net/http"
	"os"
	"time"
)

func main() {
	payload, err := json.Marshal(map[string]any{
		"html":             "<h1>Invoice #1042</h1><p>Total: $2,508.00</p>",
		"format":           "A4",
		"margin":           "20mm",
		"print_background": true,
	})
	if err != nil {
		panic(err)
	}

	req, err := http.NewRequest(http.MethodPost,
		"https://api.nippypdf.com/v1/pdf", bytes.NewReader(payload))
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer "+os.Getenv("NIPPYPDF_API_KEY"))
	req.Header.Set("Content-Type", "application/json")

	client := &http.Client{Timeout: 30 * time.Second}
	resp, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	if resp.StatusCode != http.StatusOK {
		body, _ := io.ReadAll(resp.Body)
		panic(fmt.Sprintf("NippyPDF error %d: %s", resp.StatusCode, body))
	}

	pdf, err := io.ReadAll(resp.Body)
	if err != nil {
		panic(err)
	}
	if err := os.WriteFile("invoice.pdf", pdf, 0o644); err != nil {
		panic(err)
	}
	fmt.Println("Wrote invoice.pdf")
}

All request options

POST https://api.nippypdf.com/v1/pdf accepts JSON; the response body is the binary PDF. Options mirror Chromium’s print pipeline:

{
  "html": "<h1>…</h1>",              // or "url": "https://example.com/invoice/1042"
  "format": "A4",                     // "A4" | "Letter" | "Legal" | { "width": "210mm", "height": "297mm" }
  "margin": "20mm",                   // uniform, or { "top": "…", "right": "…", "bottom": "…", "left": "…" }
  "landscape": false,
  "scale": 1.0,                       // 0.1 – 2.0
  "print_background": true,
  "wait_until": "networkidle",        // "load" | "domcontentloaded" | "networkidle"
  "header_html": "<span></span>",     // running header (use sparingly)
  "footer_html": "<span class=\"pageNumber\"></span> / <span class=\"totalPages\"></span>"
}

For pagination control — keeping blocks together, repeating table headers, paper sizes — see the page-break CSS guide.

The self-hosted alternatives, honestly

• chromedp / go-rod: drive a real Chromium over CDP — correct output, but now your Go binary manages browser processes and their memory. Read more →
• wkhtmltopdf bindings: CGo or shell-outs to an engine unmaintained since 2020. Read more →

If those trade-offs are fine for your workload, they are honest choices. The API exists for teams who want Chrome’s output without operating Chrome.

FAQ

Try your own markup in the live in-browser demo, or jump to another language: Node.js, Python, PHP, Ruby, C#.