Cómo convertir un PDF a un archivo de imagen en Node.js

¿Cómo instalo IronPDF for Node.js?

npm install @ironsoftware/ironpdf

npm install @ironsoftware/ironpdf

Instale el paquete de Node.js de IronPDF desde npm para convertir PDFs en formatos de imagen PNG, JPG, GIF, BMP y otros.

Antes de convertir PDFs a imágenes en producción, configure su clave de licencia. El paquete también requiere que se instale IronPDF Engine en su sistema; este binario maneja todas las operaciones de representación de PDF y debe estar presente para que la conversión funcione.

¿Cómo convierto un PDF en una imagen?

El método rasterizeToImageFiles lee un documento PDF y escribe un archivo de imagen por página en la ruta de salida que usted proporciona. Para los PDFs de una sola página, produce exactamente una imagen. Para PDFs de múltiples páginas, agrega un sufijo de número de página a cada nombre de archivo automáticamente.

El siguiente ejemplo carga un PDF de muestra de Learning Container y lo convierte en un archivo PNG.

El archivo PDF de muestra abierto en un visor. Descargue este archivo y otros PDFs de prueba desde Learning Container.

//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-pdf-to-image/convert-to-png.js
import { PdfDocument } from "@ironsoftware/ironpdf";

// Load the PDF and convert it to a PNG image.
// The output path determines the format — change .png to .jpg for JPEG output.
PdfDocument.fromFile("./sample-pdf-file.pdf").then((pdf) => {
    pdf.rasterizeToImageFiles("./images/sample-pdf-file.png");
    return pdf;
}).catch((error) => {
    console.error("Error converting PDF to image:", error);
});

PdfDocument.fromFile carga el PDF y devuelve una Promesa que resuelve a un objeto PdfDocument. El callback .then recibe el documento resuelto y llama a rasterizeToImageFiles con la ruta de destino. La extensión del archivo en la ruta — .png aquí — indica a IronPDF qué formato producir. El bloque .catch maneja cualquier error de lectura o conversión.

El PNG generado a partir del PDF de muestra anterior. IronPDF convierte el documento en tres líneas de código.

Para ejemplos más detallados de las opciones de este método, consulte la página de ejemplo de código de PDF a Imágenes.

¿Cómo convierto un PDF en formato JPEG?

La selección de formato es automática: cualquier extensión que pase a rasterizeToImageFiles determina el formato de salida. Para producir un JPEG en lugar de un PNG, cambie la extensión en la ruta de destino:

//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-pdf-to-image/convert-to-jpeg-extension.js
// Switch to JPEG by changing the file extension in the output path.
pdf.rasterizeToImageFiles("./images/pdf-to-jpeg.jpg");

Cuando no se puede controlar el nombre del archivo de salida — por ejemplo, en canalizaciones automatizadas con esquemas de nombres fijos — pase un valor ImageType en el objeto de opciones para anular la detección basada en la extensión:

//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-pdf-to-image/convert-to-jpeg-imagetype.js
import { PdfDocument, ImageType } from "@ironsoftware/ironpdf";

// ImageType.JPG forces JPEG output regardless of the file extension.
const options = {
    type: ImageType.JPG,
    dpi: 300
};
PdfDocument.fromFile("./sample-pdf-file.pdf").then((pdf) => {
    pdf.rasterizeToImageFiles("./images/output.png", options);
    return pdf;
});

La propiedad type en el objeto de opciones tiene prioridad sobre la extensión del nombre del archivo. En el ejemplo anterior, rasterizeToImageFiles produce un archivo JPEG aunque la ruta de destino termine con .png. El mismo patrón se aplica a las salidas GIF y BMP.

¿Cómo convierto un PDF de múltiples páginas en imágenes?

Para documentos con más de una página, rasterizeToImageFiles crea una imagen por página. IronPDF añade un índice de página basado en cero a cada nombre de archivo de salida, manteniendo la salida organizada sin código adicional de su parte.

Un PDF de muestra de dos páginas. IronPDF crea un archivo de imagen por página durante la conversión.

//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-pdf-to-image/convert-multipage.js
import { PdfDocument } from "@ironsoftware/ironpdf";

// Each page of the PDF becomes a separate image file.
// Output filenames: multipage-pdf-page_1.png, multipage-pdf-page_2.png, etc.
PdfDocument.fromFile("./multipage-pdf.pdf").then((pdf) => {
    pdf.rasterizeToImageFiles("./images/multipage-pdf/multipage-pdf-page.png");
});

Los dos archivos PNG producidos a partir del PDF de dos páginas. IronPDF nombra cada archivo de salida con su número de página.

Este comportamiento automático de división de páginas funciona con todos los formatos de imagen compatibles. Combínelo con la opción fromPages en la siguiente sección para convertir solo páginas específicas de documentos grandes. Para trabajar en la dirección opuesta, el ejemplo de imagen a PDF muestra cómo combinar múltiples archivos de imagen en un solo documento PDF.

¿Cómo convierto solo páginas específicas?

La propiedad fromPages en el objeto de opciones acepta un array de índices de página basados en cero. Solo se rasterizan las páginas especificadas; todas las demás se omiten. Esto es útil al trabajar con PDFs grandes donde solo se necesita un subconjunto de páginas, por ejemplo, para extraer las páginas de portada y de inicio de sección para una vista previa del documento. Cuando necesita trabajar con páginas individuales antes de convertirlas, la referencia de API de Node.js para PdfDocument documenta operaciones adicionales a nivel de página.

//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-pdf-to-image/convert-selective-pages.js
import { PdfDocument, ImageType } from "@ironsoftware/ironpdf";

// Convert only pages 1, 4, 6, and 9 (zero-indexed: 0, 3, 5, 8) to BMP.
const options = {
    type: ImageType.BMP,
    fromPages: [0, 3, 5, 8],
    dpi: 150
};
PdfDocument.fromFile("./sample-pdf-with-images.pdf").then((pdf) => {
    pdf.rasterizeToImageFiles(
        "./images/multipage-selective-pdf/multipage-pdf-page.bmp",
        options
    );
}).catch((error) => {
    console.error("Failed to convert pages:", error);
});

IronPDF solo rasterizó las cuatro páginas especificadas en el array fromPages. Las otras páginas no fueron procesadas.

Los índices de página en fromPages están basados en cero, por lo que [0, 3, 5, 8] apunta a la primera, cuarta, sexta y novena páginas. El valor de DPI de 150 equilibra la calidad de salida y el tamaño del archivo, adecuado para casos de uso de archivo o vista previa. La conversión selectiva es compatible con todos los tipos de imagen admitidos.

¿Cuáles son los siguientes pasos para la conversión de PDF a imagen?

El método rasterizeToImageFiles de IronPDF maneja la selección de formato, división de múltiples páginas, y conversión selectiva de páginas en una API consistente. El objeto de opciones es el único punto de extensión para anular el formato, controlar el DPI y filtrar las páginas.

Para ir más allá, la referencia de API de IronPDF Node.js documenta todos los parámetros disponibles en rasterizeToImageFiles y la clase PdfDocument. El ejemplo de código de PDF a Imágenes muestra rasterizeToImageFiles utilizado con configuración adicional. Para trabajar en la dirección opuesta, vea convertir imágenes a archivos PDF o convertir archivos TIFF de múltiples marcos a PDF.

Comience su prueba gratuita de IronPDF for Node.js para probar la conversión de PDF a imagen en su propio proyecto. Vea las opciones de licencia para encontrar el plan que se adapte a su equipo.

¿Listo para ver qué más puede hacer IronPDF? Consulte el tutorial completo de Node.js aquí: HTML a PDF en Node.js