rustedf.cloud
Menú

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.

← Todos los artículos