HTML a PDF: ¿biblioteca, navegador headless o API? Cómo elegir
Publicado el 4 min de lectura
Hay tres formas habituales de convertir HTML en PDF: una biblioteca dentro de tu aplicación, un navegador que ejecutas sin pantalla y una API que hace el trabajo en otro sitio. Ninguna es la respuesta correcta para todos los proyectos. Esta guía compara las tres en lo que tienes que ejecutar, en el HTML y el CSS que obtienes y en el destino del documento, y termina con las preguntas que deciden.
Las tres formas
Una biblioteca en tu aplicación. Añades un paquete y lo llamas. Compone el HTML y el CSS con su propio motor, así que puede ser pequeña y rápida de empezar. Suele admitir un subconjunto de CSS, y lo que queda fuera del subconjunto lo resuelves tú. Se ejecuta en tu proceso, con la memoria y los fallos que eso conlleva, y la mantienes actualizada tú.
Un navegador headless. Ejecutas un navegador de verdad sin ventana y le pides que imprima una página. Obtienes el soporte de HTML y CSS del navegador, incluido JavaScript. A cambio, instalas el navegador en cada entorno, le das memoria y tiempo para cada documento y lo mantienes actualizado. Con volumen, administras un conjunto de navegadores, colas y reinicios.
Una API. Envías el HTML y los datos en una petición y recibes un PDF. No hay nada que instalar ni que mantener en marcha, y el coste crece con el número de documentos. El documento y sus datos salen de tu infraestructura, dependes de que el servicio esté disponible, y sus límites (el tamaño de una petición, las páginas de un documento, la tasa de llamadas) te afectan.
Qué pide cada una
| Aspecto | Biblioteca | Navegador headless | API |
|---|---|---|---|
| Qué ejecutas | Un paquete en tu app | Un navegador en cada entorno | Nada, una llamada de cliente |
| HTML y CSS que obtienes | Lo que admite el motor | Lo que admite el navegador | Lo que admite el servicio |
| JavaScript al generar | Normalmente no | Sí | Depende del servicio |
| Adónde van los datos | Se quedan contigo | Se quedan contigo | Van al servicio |
| Quién actualiza | Tú | Tú | El servicio |
| El coste crece con | Tus servidores | Tus servidores | El número de documentos |
Dónde encaja rustedf.cloud
Es la tercera forma, y tiene límites claros. Los documentos se componen para el papel: páginas,
tablas que continúan en varias páginas, encabezados y pies, números de página. Admite un
subconjunto definido de HTML y CSS y no ejecuta JavaScript. Las imágenes deben subirse a tu
cuenta o incrustarse como URL data:, porque el servicio nunca descarga una dirección que venga de
una plantilla. Todo lo que queda fuera del subconjunto se ignora y se informa, y un endpoint de
validación te dice qué antes de que lo envíes.
A cambio, no hay navegador que ejecutar, hay plantillas con vista previa en vivo en un portal, formato de números, monedas y fechas para cualquier idioma, y una generación que falla no cuesta nada.
Preguntas que deciden
- ¿Tus documentos necesitan JavaScript para componerse? Si un gráfico o un diseño lo dibuja un script, necesitas un navegador o algo que lo ejecute. Una API basada en plantillas no sirve.
- ¿Los datos deben quedarse dentro de tu infraestructura? Si un contrato o una norma lo exige, usa una biblioteca o tu propio navegador.
- ¿Cuántos documentos, y con qué regularidad? Unos miles al mes, en ráfagas, encajan bien con una API. Un volumen muy grande y constante puede salir más barato si lo ejecutas tú.
- ¿Quién lo mantendrá en marcha? Si nadie del equipo quiere ocuparse de un conjunto de navegadores, es un coste que no aparece en la primera semana.
- ¿Cuánto de la página web hay que reproducir? Una factura, un presupuesto, un informe o un certificado caben en el subconjunto orientado al papel. Una página copiada de una aplicación web compleja quizá no.
Si la mayoría de las respuestas apunta a “documentos construidos a partir de datos, pensados para el papel, nada que mantener”, prueba la API con un documento real y valídalo. El plan gratuito sirve exactamente para eso.
Consulta HTML y CSS admitidos y Generar un PDF.
Sigue leyendo
Primeros pasos
HTML y CSS para PDF: qué funciona y cómo comprobarlo
Un PDF está paginado, no se desplaza. Mira qué HTML y CSS admite un generador de PDF, qué dejar fuera y cómo validar un documento antes de enviarlo.
3 min de lectura
Primeros pasos
Cómo generar una factura en PDF con una API
Crea una plantilla de factura con líneas en bucle, moneda y fecha por país, y genera el PDF con una petición. Ejemplo completo en HTML y curl.
2 min de lectura
Primeros pasos
Cómo generar un PDF desde HTML con una sola petición
Envía HTML y datos en un POST y recibe el PDF. Ejemplo con curl y Node.js, y qué saber sobre imágenes, límites y créditos.
2 min de lectura
Código e integraciones
Generar un PDF en ASP.NET Core: MVC, Razor Pages y minimal APIs
Convierte una vista Razor en PDF en ASP.NET Core con una llamada a la API: renderizador de vistas, vista lista para imprimir, acción MVC y handler de Razor Pages.
3 min de lectura