Escribe Go. Obtén un PDF.

gpdf es una biblioteca PDF para Go sin dependencias fuera de la biblioteca estándar. Maqueta páginas en una cuadrícula de 12 columnas, incrusta fuentes japonesas, chinas y coreanas, y renderiza una página en unos 13 µs.

$go get github.com/gpdf-dev/gpdf
Cómo funciona
invoice.go
doc := template.New(template.WithPageSize(document.A4))
page := doc.AddPage()

page.AutoRow(func(r *template.RowBuilder) {
    r.Col(6, func(c *template.ColBuilder) {
        c.Text("ACME Corporation", template.FontSize(24),
            template.Bold(), template.TextColor(navy))
    })
    r.Col(6, func(c *template.ColBuilder) {
        c.Text("INVOICE", template.FontSize(28),
            template.Bold(), template.AlignRight())
    })
})

page.AutoRow(func(r *template.RowBuilder) {
    r.Col(12, func(c *template.ColBuilder) {
        c.Table(header, items,
            template.ColumnWidths(40, 15, 20, 25),
            template.TableStripe(pdf.RGBHex(0xF5F5F5)),
        )
    })
})

data, err := doc.Generate()
invoice.pdfAbrir el PDF
Factura PDF generada por gpdf: cabecera de empresa, datos del cliente, tabla de conceptos con franjas y totales

Go puro, nada más.

go.mod solo lista Go. Sin cgo, sin navegador headless, sin binario nativo junto a tu servicio.

Un diseño que ya conoces.

Filas y una cuadrícula de 12 columnas fluyen por las páginas. Las tablas se dividen entre páginas y el texto se ajusta solo.

Cualquier escritura, incrustada.

Las fuentes TrueType se reducen a los glifos que usas, así el japonés, chino y coreano se ven igual en cualquier servidor.

Benchmarks

Lo bastante rápido para generar dentro de la petición.

Los mismos cuatro documentos hechos con gpdf, go-pdf/fpdf, signintech/gopdf y maroto v2. Tiempo y memoria por documento; menos es mejor.

Una página
Una página A4 con un título y un párrafo
gpdf
x
13 µs
fpdf
x
132 µs
gopdf
x
423 µs
maroto v2
x
237 µs
10–33× más rápidotiempo
Tabla (4×10)
Una tabla con estilo y fila de cabecera
gpdf
x
108 µs
fpdf
x
241 µs
gopdf
x
835 µs
maroto v2
x
8600 µs
2–80× más rápidotiempo
100 páginas
La misma página repetida 100 veces
gpdf
x
683 µs
fpdf
x
11.700 µs
gopdf
x
8600 µs
maroto v2
x
19.800 µs
13–29× más rápidotiempo
Documento complejo
Títulos, tablas y texto mezclados
gpdf
x
133 µs
fpdf
x
254 µs
gopdf
x
997 µs
maroto v2
x
10.400 µs
2–78× más rápidotiempo
Una página, memoria
Memoria asignada al construir una página
gpdf
x
16 KB
fpdf
x
1200 KB
gopdf
x
1800 KB
maroto v2
x
61 KB
4–113× menos memoriamemoria
100 páginas, memoria
Memoria asignada al construir 100 páginas
gpdf
x
909 KB
fpdf
x
121.000 KB
gopdf
x
83.000 KB
maroto v2
x
4000 KB
4–133× menos memoriamemoria

Mediana de 5 ejecuciones, 100 iteraciones cada una. Apple M1, Go 1.25. El código del benchmark está en el repositorio de gpdf.

Ver el código del benchmark

Arquitectura nativa de Go

Hecho en Go. Nada más que ejecutar.

Muchas soluciones PDF para Go salen del lenguaje: un navegador headless en un sidecar, un servicio HTML a PDF por HTTP o un binding a una biblioteca nativa. Cada una añade un runtime que desplegar, parchear y vigilar.

gpdf está escrito en Go desde la primera línea. Se compila dentro de tu binario, funciona donde funcione Go y todo su árbol de dependencias es la biblioteca estándar: tu equipo de seguridad no tiene nada extra que auditar.

Un go get, un binario, la misma salida en desarrollo y en producción.

Montaje habitual

Tu app en Go

Llamada HTTP o binding cgo

Navegador headless · JVM · biblioteca nativa

Un runtime más que desplegar, parchear y vigilar.

gpdf

Tu app en Go

go get

github.com/gpdf-dev/gpdf

Un binario · solo stdlib · sin cgo

Funciona en

LinuxmacOSWindowsDockerServerless

CJK de primera clase

Japonés, chino y coreano, tal como se escriben.

Muchas bibliotecas PDF tratan el CJK como algo secundario. gpdf se diseñó con él desde el primer día.

  • Incrusta cualquier fuente TrueType; solo se escriben en el archivo los glifos que usas.

  • Mezcla japonés, chino, coreano y texto latino en un mismo párrafo o tabla.

  • Sin tofu (□), sin mojibake y sin depender de las fuentes del servidor.

Leer la guía de fuentes
Texto japonés renderizado por gpdf con un subconjunto incrustado de Noto Sans JPUna tabla de gpdf que mezcla japonés, chino y coreano

日本語 · 中文 · 한국어

Más que maquetación.

Archivado, seguridad y posprocesado vienen en el mismo módulo, y aun así solo con la biblioteca estándar de Go.

PDF/A

Salida PDF/A-1b y PDF/A-2b con metadatos XMP, para documentos que deben poder leerse durante décadas.

Cifrado AES-256

Contraseñas de propietario y de usuario con control de impresión, copia y edición.

Firmas digitales

Firmas PKCS#7 con sellos de tiempo RFC 3161 sobre el PDF terminado.

Encabezados y pies

Encabezados, pies y números de página que se repiten en cada página.

Códigos QR y de barras

QR y Code 128 generados de forma nativa, junto a imágenes PNG y JPEG.

Unir y dividir

Combina PDF o extrae rangos de páginas sin salir de Go.

Y más…

Superpone contenido en PDF existentes y aplana campos AcroForm rellenados.

Ver los ejemplos

gpdf y las alternativas

Elegir una biblioteca PDF es más que funciones.

Qué despliegas, qué pagas y qué tienes que mantener parcheado.

gpdfSDK comerciales de GoHTML a PDF (navegador headless)
LicenciaMIT, gratis para uso comercialLicencia de pago o clave por usoCódigo abierto, pero ejecutas el navegador
DependenciasSolo la biblioteca estándar de GoMódulos del proveedorUn navegador en cada imagen
DespliegueDentro de tu binario GoBinario Go más clave de licenciaSidecar o servicio aparte
Texto CJKIntegrado, con subconjuntosDepende de la configuración de fuentesDepende de las fuentes de la imagen
Una páginaUnos 13 µsVaría según el productoUn renderizado de navegador por petición

De go get a producción.

Elige la entrada que encaje con tu stack. Las tres usan el mismo motor de renderizado.

Instala en una línea

go get github.com/gpdf-dev/gpdf. Funciona con Go 1.22 o superior.

Builder API

Go fluido y con tipos: PageBuilder → RowBuilder → ColBuilder.

Esquema JSON

Describe documentos en JSON y envíalos desde cualquier servicio o lenguaje.

Plantillas Go

Controla el esquema JSON con text/template: una fuente para miles de documentos.

Plantillas listas

Facturas, recibos y presupuestos que puedes copiar y adaptar.

Ejemplos ejecutables

Cada ejemplo es un test que genera un PDF real, de tablas a firmas.

Tests con archivos golden

Antes de cada versión, cada ejemplo se compara byte a byte con un PDF guardado.

Conformidad verificada

La CI valida los archivos generados contra la especificación PDF.

Go 1.22 a 1.26

La CI ejecuta toda la suite con el detector de carreras en cada versión de Go soportada.

FAQ

Preguntas antes de publicar

gpdf es una biblioteca de generación de PDF con licencia MIT escrita en Go puro y sin dependencias externas. Maqueta páginas en una cuadrícula de 12 columnas e incrusta fuentes TrueType, incluidas japonesas, chinas y coreanas.

Publica tu primer PDF hoy.

Un go get y unas pocas líneas de Go.