Python을 사용하여 여러 PDF 파일을 하나의 PDF로 병합하기

필요한 가져오기 선언은 무엇인가요?

Python 스크립트에서 IronPDF의 PDF 생성 및 병합 기능에 접근하기 위해 다음 import 선언을 포함하세요:

#: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"

프로덕션 애플리케이션의 경우, 라이선스 키를 구성하여 IronPDF의 모든 기능을 잠금 해제 하세요. 무료 체험이 제공되며, 무료 체험을 시작하여 구매 없이 시작하세요.

PDF 생성에 RenderHtmlAsPdf를 사용하는 이유는 무엇일까요?

위 예제는 두 페이지 문서를 각각 나타내는 두 HTML 문자열을 사용합니다. RenderHtmlAsPdf는 IronPDF의 Chrome 기반 렌더링 엔진을 사용하여 각 문자열을 PdfDocument 객체로 변환하며, 이 엔진은 HTML, CSS 및 JavaScript 콘텐츠에서 정확한 결과를 생성합니다. 이 접근 방식은 보고서 또는 웹 템플릿에서 데이터 기반 문서를 생성하는 데 적합합니다. 더 복잡한 렌더링 시나리오에 대해서는 HTML to PDF 튜토리얼을 참조하세요.

Merge 메서드는 어떻게 작동하나요?

PdfDocument.Merge는 PdfDocument 객체들로 구성된 Python 리스트를 유일한 인수로 받습니다. 문서들을 목록 순서대로 결합하여 첫 번째 문서의 모든 페이지를 두 번째 문서의 모든 페이지 앞에 배치하고, 이와 같이 결합합니다. 결과물은 추가 수정이나 저장이 가능한 새로운 PdfDocument입니다. 각 소스 문서의 페이지 수, 북마크 및 내장 콘텐츠는 모두 출력에 보존됩니다.

메서드는 동일한 목록에 렌더링된 문서와 파일로 읽어들인 문서를 혼합하여 수락합니다. 이는 한 번의 호출로 새로 렌더링된 HTML 출력과 디스크에서 가져온 기존 PDF를 결합할 수 있음을 의미하며, 보고서의 한 부분은 동적으로 생성되고 다른 부분은 정적 템플릿일 때 유용합니다.

병합된 PDF를 어떻게 저장합니까?

합쳐진 문서를 디스크에 저장하려면 원하는 출력 경로를 SaveAs에 전달하십시오:

#: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")

저장 후, 대용량 병합 문서의 파일 크기를 줄이기 위해 PDF 압축과 같은 추가 후처리를 적용할 수 있습니다.

병합된 PDF 출력은 두 원본 문서의 페이지를 보여줍니다.

목록을 사용해 여러 PDF를 어떻게 결합합니까?

아래 코드는 한 번의 호출로 네 개의 HTML-렌더링된 문서를 병합합니다:

#: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")

Merge에 전달된 목록은 최종 문서의 페이지 순서를 결정합니다. 목록의 요소를 재배열하면 추가 코드 없이 출력 순서를 변경할 수 있습니다. 병합 전에 문서를 정렬해야 하는 경우(예: 날짜나 보고서 번호 기준), 먼저 Python 리스트를 정렬한 다음 Merge로 전달하십시오.

디스크에서 기존 PDF 파일을 어떻게 병합합니까?

새로 렌더링된 파일이 아닌 기존 PDF 파일을 병합할 때는, 병합하기 전에 각 파일을 PdfDocument.FromFile로 불러와야 합니다. 이는 다른 시스템에서 생성된 파일 - 스캔된 문서, 서드파티 보고서 내보내기, 또는 다른 도구로 생성된 PDF - 를 처리할 때의 일반적인 패턴입니다. IronPDF는 파일을 PdfDocument 객체로 메모리에 읽어들이며, 이 객체는 최종 저장 전에 병합, 수정 또는 확인이 가능합니다.

#: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")

모든 네 개의 소스 PDF에서 페이지를 보여주는 다중 문서 병합 결과