1. IronPDF
  2. Guías
  3. Fusionar PDFs
Cómo combinar archivos PDF usando Python | IronPDF

Fusionar archivos PDF en un único PDF con Python

Curtis Chau
Curtis Chau
Actualizado:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF for Python proporciona una solución directa para combinar múltiples documentos PDF en un solo archivo utilizando el método PdfDocument.Merge(), compatible tanto con la fusión de dos archivos como con operaciones por lotes para combinar numerosos PDFs de manera eficiente.

PDF (Formato de Documento Portátil) es el estándar para compartir documentos que deben verse idénticos en todas las plataformas y aplicaciones. Ya sea que esté consolidando informes, combinando documentos escaneados o ensamblando formularios de varias partes, fusionar contenido PDF de varias fuentes es un requisito recurrente en los flujos de trabajo de negocios y de procesamiento de datos.

IronPDF maneja esta operación en Python con una sola llamada de método. Esta guía cubre la instalación, la fusión básica de dos archivos y las operaciones por lotes para combinar múltiples documentos a la vez.

Inicio rápido: fusionar archivos PDF en Python

#:path=/static-assets/pdf/content-code-examples/how-to/python-merge-pdf/quickstart.py
from ironpdf import *

renderer = ChromePdfRenderer()
pdf_a = renderer.RenderHtmlAsPdf("<p>Document A</p>")
pdf_b = renderer.RenderHtmlAsPdf("<p>Document B</p>")

merged = PdfDocument.Merge([pdf_a, pdf_b])
merged.SaveAs("merged.pdf")
#:path=/static-assets/pdf/content-code-examples/how-to/python-merge-pdf/quickstart.py
from ironpdf import *

renderer = ChromePdfRenderer()
pdf_a = renderer.RenderHtmlAsPdf("<p>Document A</p>")
pdf_b = renderer.RenderHtmlAsPdf("<p>Document B</p>")

merged = PdfDocument.Merge([pdf_a, pdf_b])
merged.SaveAs("merged.pdf")
PYTHON

Flujo de trabajo mínimo (5 pasos)

  1. Instalar la biblioteca Python para combinar archivos PDF
  2. Use RenderHtmlAsPdf para generar archivos PDF individuales, o cargue los existentes con PdfDocument.FromFile
  3. Aplique el método Merge para combinar archivos PDF en un solo PdfDocument
  4. Guarde el documento fusionado con SaveAs
  5. Para múltiples PDFs, pase una lista de objetos PdfDocument a Merge

¿Cómo instalo IronPDF for Python?

IronPDF está disponible como un paquete de Python a través de pip. Requiere Python 3.x y funciona en Windows y Linux sin depender de sistemas adicionales para operaciones de fusión estándar. El paquete viene con un motor de renderizado basado en Chrome que maneja la conversión de HTML a PDF internamente.

Instala la biblioteca IronPdf usando pip con el siguiente comando:

#:path=/static-assets/pdf/content-code-examples/how-to/python-merge-pdf/install.sh
pip install ironpdf
#:path=/static-assets/pdf/content-code-examples/how-to/python-merge-pdf/install.sh
pip install ironpdf
SHELL

Para instrucciones detalladas de instalación y ayuda con problemas comunes como errores "Módulo no definido" o problemas de permisos, consulte la documentación oficial.

¿Qué declaraciones de importación se requieren?

En su script de Python, incluya las siguientes declaraciones de importación para acceder a las funciones de generación y fusión de PDFs de IronPDF:

#:path=/static-assets/pdf/content-code-examples/how-to/python-merge-pdf/imports.py
from ironpdf import *

# Set your license key for production use
License.LicenseKey = "YOUR-LICENSE-KEY-HERE"
#:path=/static-assets/pdf/content-code-examples/how-to/python-merge-pdf/imports.py
from ironpdf import *

# Set your license key for production use
License.LicenseKey = "YOUR-LICENSE-KEY-HERE"
PYTHON

Para aplicaciones de producción, configure su clave de licencia para desbloquear el conjunto completo de características de IronPDF. Una prueba gratuita está disponible - comience su prueba gratuita para comenzar sin compra.

¿Cómo combinar dos archivos PDF en Python?

Combinar archivos PDF en Python implica dos pasos: crear los documentos PDF de origen, luego combinarlos con PdfDocument.Merge(). El método acepta una lista de objetos PdfDocument y produce un nuevo documento combinado en el orden en que los elementos aparecen en la lista.

A continuación hay un ejemplo completo y funcional:

#:path=/static-assets/pdf/content-code-examples/how-to/python-merge-pdf/merge-two-pdfs.py
from ironpdf import *

# HTML content for the first PDF
html_a = """<p> [PDF_A] </p>
            <p> [PDF_A] 1st Page </p>
            <div style='page-break-after: always;'></div>
            <p> [PDF_A] 2nd Page</p>"""

# HTML content for the second PDF
html_b = """<p> [PDF_B] </p>
            <p> [PDF_B] 1st Page </p>
            <div style='page-break-after: always;'></div>
            <p> [PDF_B] 2nd Page</p>"""

# Initialize renderer
renderer = ChromePdfRenderer()

# Convert each HTML string to a PDF document
pdfdoc_a = renderer.RenderHtmlAsPdf(html_a)
pdfdoc_b = renderer.RenderHtmlAsPdf(html_b)

# Merge the two documents into one
merged = PdfDocument.Merge([pdfdoc_a, pdfdoc_b])

# Save the merged result to disk
merged.SaveAs("Merged.pdf")
#:path=/static-assets/pdf/content-code-examples/how-to/python-merge-pdf/merge-two-pdfs.py
from ironpdf import *

# HTML content for the first PDF
html_a = """<p> [PDF_A] </p>
            <p> [PDF_A] 1st Page </p>
            <div style='page-break-after: always;'></div>
            <p> [PDF_A] 2nd Page</p>"""

# HTML content for the second PDF
html_b = """<p> [PDF_B] </p>
            <p> [PDF_B] 1st Page </p>
            <div style='page-break-after: always;'></div>
            <p> [PDF_B] 2nd Page</p>"""

# Initialize renderer
renderer = ChromePdfRenderer()

# Convert each HTML string to a PDF document
pdfdoc_a = renderer.RenderHtmlAsPdf(html_a)
pdfdoc_b = renderer.RenderHtmlAsPdf(html_b)

# Merge the two documents into one
merged = PdfDocument.Merge([pdfdoc_a, pdfdoc_b])

# Save the merged result to disk
merged.SaveAs("Merged.pdf")
PYTHON

¿Por qué utilizar RenderHtmlAsPdf para la generación de PDF?

El ejemplo anterior utiliza dos cadenas HTML, cada una representando un documento de dos páginas. RenderHtmlAsPdf convierte cada cadena en un objeto PdfDocument utilizando el motor de renderizado basado en Chrome de IronPDF, que produce resultados precisos a partir de contenido HTML, CSS y JavaScript. Este enfoque es adecuado para generar informes o documentos impulsados por datos desde plantillas web. Para escenarios de renderizado más complejos, vea el tutorial de HTML a PDF.

ConsejosTambién puedes cargar archivos PDF existentes desde el disco usando PdfDocument.FromFile("path/to/file.pdf") y pasarlos directamente al método Merge. Esto es útil cuando se combinan informes preexistentes o documentos generados externamente.

¿Cómo funciona el método Merge?

PdfDocument.Merge toma una lista de objetos PdfDocument de Python como su único argumento. Combina los documentos en orden de lista, colocando todas las páginas del primer documento antes que todas las páginas del segundo, y así sucesivamente. El resultado es un nuevo PdfDocument que se puede modificar o guardar posteriormente. El recuento de páginas, los marcadores y el contenido incrustado de cada documento fuente se conservan en la salida.

El método acepta cualquier combinación de documentos renderizados y cargados desde archivos en la misma lista. Esto significa que puede combinar la salida HTML renderizada recientemente con PDFs existentes desde el disco en una sola llamada, lo cual es útil cuando una parte de un informe se genera dinámicamente y otra parte es una plantilla estática.

¿Cómo guardo el PDF combinado?

Pasa la ruta de salida deseada a SaveAs para escribir el documento combinado en el disco:

#:path=/static-assets/pdf/content-code-examples/how-to/python-merge-pdf/save-merged.py
# Save the merged document
merged.SaveAs("Merged.pdf")

# Optionally compress images before saving to reduce file size
merged.CompressImages(90)
merged.SaveAs("Merged_Compressed.pdf")
#:path=/static-assets/pdf/content-code-examples/how-to/python-merge-pdf/save-merged.py
# Save the merged document
merged.SaveAs("Merged.pdf")

# Optionally compress images before saving to reduce file size
merged.CompressImages(90)
merged.SaveAs("Merged_Compressed.pdf")
PYTHON

Después de guardar, puede aplicar procesamiento posterior adicional como compresión de PDF para reducir el tamaño de archivo de documentos combinados grandes.

IronPDF output showing a 4-page merged PDF with thumbnail panel confirming successful two-document merge

Salida de PDF combinado mostrando páginas de ambos documentos fuente

¿Cómo fusiono más de dos archivos PDF en Python?

La fusión por lotes en IronPDF sigue el mismo patrón que la fusión de dos documentos. La única diferencia es que se añaden más objetos PdfDocument a la lista antes de la llamada a PdfDocument.Merge. El método se adapta para manejar docenas o cientos de documentos en una sola operación.

Esta es la misma API independientemente de si estás fusionando 2 o 200 documentos. Para escenarios de alto volumen como la agregación de informes nocturnos o las canalizaciones de ensamblaje de documentos, IronPDF también admite la generación de PDF en paralelo para acelerar la fase de renderizado antes de fusionar.

El proceso involucra dos pasos:

  • Crea una lista de Python que contenga los objetos PdfDocument para combinar
  • Pasa la lista como argumento a PdfDocument.Merge

¿Cómo combino múltiples PDFs con una lista?

El código a continuación fusiona cuatro documentos renderizados en HTML en una sola llamada:

#:path=/static-assets/pdf/content-code-examples/how-to/python-merge-pdf/merge-multiple-pdfs.py
from ironpdf import *

# HTML content for each document
html_a = """<p> [PDF_A] 1st Page </p>
            <div style='page-break-after: always;'></div>
            <p> [PDF_A] 2nd Page</p>"""

html_b = """<p> [PDF_B] 1st Page </p>
            <div style='page-break-after: always;'></div>
            <p> [PDF_B] 2nd Page</p>"""

html_c = """<p> [PDF_C] 1st Page </p>
            <div style='page-break-after: always;'></div>
            <p> [PDF_C] 2nd Page</p>"""

html_d = """<p> [PDF_D] Content Page </p>
            <div style='page-break-after: always;'></div>
            <p> [PDF_D] Summary Page</p>"""

renderer = ChromePdfRenderer()

# Render all four documents
pdfdoc_a = renderer.RenderHtmlAsPdf(html_a)
pdfdoc_b = renderer.RenderHtmlAsPdf(html_b)
pdfdoc_c = renderer.RenderHtmlAsPdf(html_c)
pdfdoc_d = renderer.RenderHtmlAsPdf(html_d)

# Collect into a list and merge
pdfs = [pdfdoc_a, pdfdoc_b, pdfdoc_c, pdfdoc_d]
pdf = PdfDocument.Merge(pdfs)

# Save the combined document
pdf.SaveAs("merged_multiple.pdf")
#:path=/static-assets/pdf/content-code-examples/how-to/python-merge-pdf/merge-multiple-pdfs.py
from ironpdf import *

# HTML content for each document
html_a = """<p> [PDF_A] 1st Page </p>
            <div style='page-break-after: always;'></div>
            <p> [PDF_A] 2nd Page</p>"""

html_b = """<p> [PDF_B] 1st Page </p>
            <div style='page-break-after: always;'></div>
            <p> [PDF_B] 2nd Page</p>"""

html_c = """<p> [PDF_C] 1st Page </p>
            <div style='page-break-after: always;'></div>
            <p> [PDF_C] 2nd Page</p>"""

html_d = """<p> [PDF_D] Content Page </p>
            <div style='page-break-after: always;'></div>
            <p> [PDF_D] Summary Page</p>"""

renderer = ChromePdfRenderer()

# Render all four documents
pdfdoc_a = renderer.RenderHtmlAsPdf(html_a)
pdfdoc_b = renderer.RenderHtmlAsPdf(html_b)
pdfdoc_c = renderer.RenderHtmlAsPdf(html_c)
pdfdoc_d = renderer.RenderHtmlAsPdf(html_d)

# Collect into a list and merge
pdfs = [pdfdoc_a, pdfdoc_b, pdfdoc_c, pdfdoc_d]
pdf = PdfDocument.Merge(pdfs)

# Save the combined document
pdf.SaveAs("merged_multiple.pdf")
PYTHON

La lista pasada a Merge determina el orden de las páginas en el documento final. Reorganizar los elementos en la lista cambia el orden de salida sin código adicional. Si necesitas ordenar documentos antes de combinar, por ejemplo, por fecha o número de informe, ordena primero la lista de Python, luego pásala a Merge.

¿Cómo fusiono archivos PDF existentes desde el disco?

Al combinar archivos PDF preexistentes en lugar de los recién renderizados, carga cada archivo con PdfDocument.FromFile antes de combinarlos. Este es el patrón típico cuando trabajas con archivos producidos por otros sistemas: documentos escaneados, exportaciones de informes de terceros o PDFs generados por diferentes herramientas. IronPDF lee el archivo en memoria como un objeto PdfDocument, que luego se puede combinar, modificar o inspeccionar antes de la guardado final.

#:path=/static-assets/pdf/content-code-examples/how-to/python-merge-pdf/merge-existing-pdfs.py
from ironpdf import *

# Load existing PDF files from disk
existing_pdf1 = PdfDocument.FromFile("report1.pdf")
existing_pdf2 = PdfDocument.FromFile("report2.pdf")
existing_pdf3 = PdfDocument.FromFile("report3.pdf")

# Merge all loaded documents
merged_existing = PdfDocument.Merge([existing_pdf1, existing_pdf2, existing_pdf3])

# Save the combined result
merged_existing.SaveAs("merged_reports.pdf")
#:path=/static-assets/pdf/content-code-examples/how-to/python-merge-pdf/merge-existing-pdfs.py
from ironpdf import *

# Load existing PDF files from disk
existing_pdf1 = PdfDocument.FromFile("report1.pdf")
existing_pdf2 = PdfDocument.FromFile("report2.pdf")
existing_pdf3 = PdfDocument.FromFile("report3.pdf")

# Merge all loaded documents
merged_existing = PdfDocument.Merge([existing_pdf1, existing_pdf2, existing_pdf3])

# Save the combined result
merged_existing.SaveAs("merged_reports.pdf")
PYTHON

Por favor notaIronPDF conserva fuentes, imágenes, anotaciones y diseños de página de los archivos fuente durante la fusión. Los documentos con campos de formulario incrustados o firmas digitales también pueden ser fusionados, aunque los campos de formulario interactivos en el resultado pueden requerir un re-flattening dependiendo de tu caso de uso.

IronPDF output showing a multi-page merged PDF with thumbnail navigation panel displaying pages from four source documents

Resultado de la fusión de varios documentos mostrando páginas de los cuatro PDFs fuente

¿Cuáles son los próximos pasos para fusionar PDFs en Python?

Esta guía cubre los dos principales patrones para combinar PDFs con IronPDF: renderizar contenido HTML en documentos PDF y combinarlos con PdfDocument.Merge, y cargar archivos existentes desde el disco para combinaciones por lotes. Ambos enfoques comparten la misma API y se escalan desde fusiones de dos archivos simples hasta grandes lotes de documentos.

IronPDF admite operaciones adicionales post-fusión como agregar encabezados y pies de página, aplicar marcas de agua para el branding, extraer texto del documento combinado y llenar formularios PDF programáticamente.

La biblioteca admite Python 3.x en Windows y Linux. Para más operaciones con PDF en Python, explora dividir PDFs, convertir PDFs a imágenes y imprimir PDFs. Para la lista completa de ejemplos de código en Python, visita la página de ejemplos de IronPDF for Python.

Comienza tu prueba gratuita para probar la fusión de PDFs en tu entorno, o mira las opciones de licencia para implementaciones de producción.

¿Listo para ver qué más puedes hacer? Visita la página de tutoriales de IronPDF Python aquí: Tutoriales de IronPDF for Python

Descarga el producto de software.

Preguntas Frecuentes

¿Cómo fusiono varios archivos PDF en uno solo utilizando Python?

Instala IronPDF con pip install ironpdf, luego llama a PdfDocument.Merge() con una lista de Python de objetos PdfDocument. El método devuelve un nuevo documento combinado que guardas con SaveAs.

¿Puedo fusionar archivos PDF existentes desde el disco en lugar de los renderizados?

Sí. Usa PdfDocument.FromFile('path/to/file.pdf') para cargar cada PDF existente, luego pasa los objetos cargados a PdfDocument.Merge(). Puedes mezclar documentos cargados desde archivos y recién renderizados en la misma lista.

¿El método PdfDocument.Merge conserva el formato y las fuentes del documento?

Sí. IronPDF conserva las fuentes, imágenes, anotaciones y disposiciones de página de todos los documentos de origen durante la fusión. La apariencia original de cada documento de origen se mantiene en el PDF fusionado final.

¿Cómo controlo el orden de las páginas en el PDF fusionado?

El orden de las páginas en la salida coincide con el orden de los objetos PdfDocument en la lista de Python pasada a Merge. Reorganiza los elementos de la lista antes de llamar a Merge para controlar la secuencia.

¿Puedo comprimir el PDF fusionado para reducir el tamaño del archivo?

Sí. Después de fusionar, llama a CompressImages(quality) en el PdfDocument fusionado antes de llamar a SaveAs. Un valor de calidad de 90 ofrece un buen equilibrio entre compresión y fidelidad visual.

¿IronPDF for Python es multiplataforma?

Sí. IronPDF for Python admite Python 3.x en Windows y Linux. La misma API PdfDocument.Merge() funciona en ambas plataformas sin cambios de configuración.

¿Puedo añadir metadatos al documento PDF fusionado?

Sí. Después de fusionar, establece propiedades de metadatos como pdf.MetaData.Author y pdf.MetaData.Title en el PdfDocument fusionado antes de guardar.

Curtis Chau
Curtis Chau
  Chatea con el equipo de ingeniería ahora
Escritor Técnico

Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien ...

Leer más
¿Listo para empezar?
Versión: 2026.5 just released
Still Scrolling Icon

¿Aún desplazándote?

¿Quieres una prueba rápida?
ejecutar una muestra Mira cómo tu HTML se convierte en PDF.