Cómo crear archivos PDF en Node.js

¿Cómo instalo IronPDF for Node.js?

Install the @ironsoftware/ironpdf package using npm. El paquete funciona con Node.js 12.0 o superior y soporta ambos formatos de módulo ESM y CommonJS.

//:path=/static-assets/pdf/content-code-examples/tutorials/nodejs-create-pdf/install.sh
npm install @ironsoftware/ironpdf

//:path=/static-assets/pdf/content-code-examples/tutorials/nodejs-create-pdf/install.sh
npm install @ironsoftware/ironpdf

IronPDF for Node.js depende del binario de IronPDF Engine, que maneja el renderizado subyacente basado en Chromium. El motor se descarga automáticamente en la primera ejecución, pero puedes preinstalar el paquete específico de la plataforma para evitar descargas en tiempo de ejecución. Esto es útil en entornos de red restringidos o tuberías de CI basadas en Docker:

¿Cómo creo un PDF a partir de HTML en Node.js?

Usa PdfDocument.fromHtml() para generar un PDF a partir de una cadena HTML. El método acepta cualquier HTML válido, incluyendo bloques <style> en línea, fuentes externas cargadas a través de CDN y sistemas de diseño como CSS Grid o Flexbox. El renderizador de Chromium resuelve todos los recursos antes de generar el PDF.

:path=/static-assets/pdf/content-code-examples/tutorials/nodejs-create-pdf/html-string-to-pdf.js

PdfDocument.fromHtml() devuelve una instancia de PdfDocument. Llama a saveAs() con la ruta de salida deseada para escribir el archivo. El método es asincrónico, así que usa await o encadena un manejador .then(). El motor de Chromium maneja la carga de fuentes, hojas de estilo externas y resolución de activos antes de capturar la salida. Para más patrones, consulta el ejemplo de HTML a PDF.

:path=/static-assets/pdf/content-code-examples/tutorials/nodejs-create-pdf/html-file-to-pdf.js

¿Cómo genero un PDF a partir de una URL?

Usa PdfDocument.fromUrl() para renderizar una página web en vivo como un PDF. El renderizador carga la página como una sesión de navegador completa, ejecutando JavaScript, aplicando CSS y esperando contenido dinámico antes de capturar la salida.

:path=/static-assets/pdf/content-code-examples/tutorials/nodejs-create-pdf/url-to-pdf.js

Para páginas que cargan contenido asincrónicamente a través de JavaScript, combínalo con una opción renderDelay (en milisegundos) para permitir tiempo adicional antes de la captura. El ejemplo de URL a PDF demuestra la configuración de retraso y cabeceras de autenticación.

---

Mi biblioteca favorita de este tipo es IronPDF. Permite una manipulación rápida y eficiente de archivos PDF. También tiene muchas funciones valiosas, como exportar al formato PDF/A y firmar documentos PDF digitalmente.

Milan Jovanovic

Microsoft MVP

Ver estudio de caso

IronOCR significa que podemos ahorrar $40,000 anualmente en el procesamiento manual, mientras mejoramos la productividad y liberamos recursos para tareas de alto impacto. Lo recomendaría encarecidamente.

Brent Matzelle

Director de Tecnología, OPYN

Ver estudio de caso

El Iron Suite juega un papel crucial en nuestras operaciones. Estas son herramientas que aumentan la eficiencia en toda la empresa, incluyendo la creación de planos y la mejora en la gestión de inventario.

David Jones

Ingeniero de Software Principal, Agorus Build

Ver estudio de caso

¿Cómo configuro las opciones de salida de PDF?

Pasa un objeto de configuración como segundo argumento a PdfDocument.fromHtml(), PdfDocument.fromFile() o PdfDocument.fromUrl(). El objeto de configuración acepta tamaño de papel, márgenes, orientación y opciones de renderizado.

:path=/static-assets/pdf/content-code-examples/tutorials/nodejs-create-pdf/pdf-settings.js

Las opciones clave de configuración incluyen:

• paperSize: acepta valores enum PdfPaperSize (A4, Carta, Legal y tamaños personalizados)
• landscape: configura true para orientación de página horizontal
• printBackground: incluye colores de fondo e imágenes CSS
• marginTop/Bottom/Left/Right: márgenes de página en milímetros
• renderDelay: milisegundos para esperar antes de la captura para páginas con mucho JavaScript

:path=/static-assets/pdf/content-code-examples/tutorials/nodejs-create-pdf/headers-footers.js

¿Cómo añado seguridad y metadatos a un PDF?

Aplica protección con contraseña y encriptación a un PDF generado usando los métodos de seguridad PdfDocument. La biblioteca admite tanto contraseñas de propietario como de usuario, con controles granulares de permisos para impresión, copiado y edición.

:path=/static-assets/pdf/content-code-examples/tutorials/nodejs-create-pdf/security.js

La encriptación y desencriptación utilizan encriptación AES de 256 bits por defecto cuando se aplican contraseñas. Para flujos de trabajo de autenticación de documentos, IronPDF también admite firmas digitales usando certificados X.509.

Para documentos que requieren cumplimiento archivístico a largo plazo, usa PdfDocument.fromHtml() seguido por el método de conversión a PDF/A. IronPDF admite cumplimiento PDF/A y estándares de accesibilidad PDF/UA.)}]

¿Cómo uno y manipulo archivos PDF existentes?

PdfDocument proporciona métodos para unir, dividir y modificar archivos PDF existentes. Carga un PDF existente con PdfDocument.fromFile() y usa los métodos de manipulación para agregar o quitar páginas, estampar contenido o reemplazar texto.

:path=/static-assets/pdf/content-code-examples/tutorials/nodejs-create-pdf/merge-pdfs.js

PdfDocument.mergePdf() acepta una matriz de instancias PdfDocument y devuelve un solo documento combinado. El orden de las páginas sigue el orden del arreglo, por lo que la salida preserva la secuencia de los archivos de entrada.

Otras operaciones comunes de manipulación:

• Elimina una página de un PDF usando removePages()
• Estampar contenido HTML en un documento existente
• Buscar y reemplazar texto en todas las páginas
• Extraer texto de un PDF para indexación o procesamiento

Para escenarios de alto volumen, la generación de PDF multihilo te permite procesar varios documentos en paralelo. La compresión de PDF reduce el tamaño de los archivos para almacenamiento y transmisión.

¿Cómo genero PDFs para contenido complejo como gráficos y páginas Angular?

IronPDF renderiza las páginas utilizando una sesión completa del navegador Chromium, lo que significa que las bibliotecas de JavaScript que producen gráficos, diagramas o visualizaciones de datos se renderizan correctamente, incluyendo bibliotecas de gráficas de JavaScript. Las aplicaciones de una sola página construidas con frameworks como Angular también se convierten limpiamente usando el ejemplo de Angular a PDF.

Para documentos con mucho contenido Unicode o salidas en varios idiomas, IronPDF maneja Unicode y conjuntos de caracteres internacionales sin configuración adicional. El ejemplo de integración con Google Fonts muestra cómo cargar fuentes web en el HTML renderizado para una tipografía consistente en el PDF de salida.

¿Cuáles son los siguientes pasos para crear PDFs en Node.js?

Esta guía ha cubierto el flujo de trabajo central de IronPDF: instalar la biblioteca, generar PDFs a partir de cadenas HTML, archivos y URLs, configurar las opciones de salida, agregar encabezados y pies de página, aplicar seguridad y manipular PDFs existentes.

Para continuar, intenta el tutorial HTML a PDF completo para una revisión más profunda de las opciones de renderizado, o explora la Referencia de API para la lista completa de métodos y propiedades de configuración PdfDocument.

Inicia tu prueba gratuita para generar PDFs sin marcas de agua, o mira las opciones de licencia para implementaciones en producción.