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.mod solo lista Go. Sin cgo, sin navegador headless, sin binario nativo junto a tu servicio.
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.
Las fuentes TrueType se reducen a los glifos que usas, así el japonés, chino y coreano se ven igual en cualquier servidor.
Benchmarks
Los mismos cuatro documentos hechos con gpdf, go-pdf/fpdf, signintech/gopdf y maroto v2. Tiempo y memoria por documento; menos es mejor.
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 benchmarkArquitectura nativa de Go
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.
Tu app en Go
Llamada HTTP o binding cgoNavegador headless · JVM · biblioteca nativa
Un runtime más que desplegar, parchear y vigilar.
Tu app en Go
go getgithub.com/gpdf-dev/gpdf
Un binario · solo stdlib · sin cgo
Funciona en
CJK de primera clase
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.
Archivado, seguridad y posprocesado vienen en el mismo módulo, y aun así solo con la biblioteca estándar de Go.
Salida PDF/A-1b y PDF/A-2b con metadatos XMP, para documentos que deben poder leerse durante décadas.
Contraseñas de propietario y de usuario con control de impresión, copia y edición.
Firmas PKCS#7 con sellos de tiempo RFC 3161 sobre el PDF terminado.
Encabezados, pies y números de página que se repiten en cada página.
QR y Code 128 generados de forma nativa, junto a imágenes PNG y JPEG.
Combina PDF o extrae rangos de páginas sin salir de Go.
gpdf y las alternativas
Qué despliegas, qué pagas y qué tienes que mantener parcheado.
Elige la entrada que encaje con tu stack. Las tres usan el mismo motor de renderizado.
go get github.com/gpdf-dev/gpdf. Funciona con Go 1.22 o superior.
Go fluido y con tipos: PageBuilder → RowBuilder → ColBuilder.
Describe documentos en JSON y envíalos desde cualquier servicio o lenguaje.
Controla el esquema JSON con text/template: una fuente para miles de documentos.
Facturas, recibos y presupuestos que puedes copiar y adaptar.
Cada ejemplo es un test que genera un PDF real, de tablas a firmas.
Antes de cada versión, cada ejemplo se compara byte a byte con un PDF guardado.
La CI valida los archivos generados contra la especificación PDF.
La CI ejecuta toda la suite con el detector de carreras en cada versión de Go soportada.
FAQ
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.
Una página se renderiza en unos 13 µs. En los benchmarks publicados, gpdf es aproximadamente de 10 a 30 veces más rápido que go-pdf/fpdf, signintech/gopdf y maroto v2 en la mayoría de los documentos.
Sí. Incrusta una fuente TrueType y gpdf escribe solo los glifos que usas. La salida no depende de las fuentes instaladas en el servidor.
Sí. gpdf tiene licencia MIT, así que puedes usarlo, modificarlo y redistribuirlo en productos comerciales.
Go 1.22 o superior. La CI ejecuta los tests en Go 1.22 a 1.26.
Un go get y unas pocas líneas de Go.