Node.js용 PDF 라이브러리를 어떻게 설치하나요?

Node.js용 IronPDF를 설치하려면 터미널에서 `npm i @ironsoftware/ironpdf` 명령을 실행하여 핵심 라이브러리를 설치하세요. 그런 다음 Windows 시스템의 경우 `npm install @ironsoftware/ironpdf-engine-windows-x64` 명령을 사용하여 필요한 엔진을 설치합니다.

Node.js용으로 설계된 PDF 라이브러리의 주요 특징은 무엇인가요?

IronPDF는 HTML 및 웹 페이지를 PDF로 변환하고, 이미지를 PDF로 컴파일하며, 다양한 애플리케이션을 위한 동적 콘텐츠 렌더링을 지원하는 등 포괄적인 PDF 생성 기능을 제공합니다.

HTML 콘텐츠를 PDF 문서로 변환하려면 어떻게 해야 하나요?

IronPDF의 PdfDocument.fromHtml 메서드를 사용하여 HTML 콘텐츠를 PDF로 변환할 수 있습니다. PdfDocument 클래스를 임포트하고, HTML 문자열에서 PDF를 생성한 다음, saveAs 메서드를 사용하여 저장하세요.

Node.js를 사용하여 웹 페이지 URL에서 PDF를 생성하는 것이 가능할까요?

네, IronPDF를 사용하면 PdfDocument.fromUrl 메서드를 통해 웹 페이지 URL에서 PDF를 생성할 수 있습니다. 변환하려는 웹 페이지의 URL을 제공한 다음 saveAs 메서드를 사용하여 PDF를 저장하세요.

여러 이미지를 하나의 PDF 파일로 합칠 수 있나요?

IronPDF는 PdfGenerator.imageToPdf 메서드를 사용하여 여러 이미지를 하나의 PDF 파일로 병합할 수 있도록 지원합니다. 변환할 이미지 경로를 지정하고 saveAs 메서드를 사용하여 결과를 PDF 파일로 저장하세요.

Node.js PDF 라이브러리를 프로젝트에서 사용하는 과정은 무엇인가요?

이 과정에는 IronPDF를 설치하고, PdfDocument 와 같은 필요한 클래스를 가져오고, fromHtml 또는 fromUrl 과 같은 메서드를 사용하여 PDF를 생성하고, saveAs 메서드를 사용하여 파일을 저장하는 단계가 포함됩니다.

Node.js에서 비동기 PDF 작업을 어떻게 처리할 수 있나요?

IronPDF는 async/await 구문을 사용하여 비동기 작업을 지원하므로 실행 흐름을 차단하지 않고 PDF 생성 및 저장과 같은 작업을 수행할 수 있습니다.

Node.js용 PDF 라이브러리 사용에 대한 추가 자료는 어디에서 찾을 수 있나요?

더 많은 자료, 튜토리얼 및 예제를 보려면 IronPDF 웹사이트를 방문하세요. 해당 웹사이트는 HTML을 PDF로 변환하는 데 초점을 맞춘 광범위한 문서와 튜토리얼 페이지를 제공합니다.

PDF 라이브러리의 기능을 살펴볼 수 있는 무료 체험판이 있나요?

네, IronPDF는 무료 평가판을 제공하여 사용자가 기능을 살펴볼 수 있도록 합니다. 자세한 내용 및 평가판 시작 방법은 문서 페이지를 참조하세요.

Node.js 애플리케이션에서 PDF 라이브러리를 사용하면 어떤 이점이 있나요?

Node.js 애플리케이션에서 IronPDF를 사용하면 다양한 콘텐츠 유형에서 PDF를 생성할 수 있고, 동적 콘텐츠를 지원하며, JavaScript 라이브러리와 쉽게 통합할 수 있어 문서 처리 기능이 향상됩니다.

Node.js PDF 라이브러리

Explore IronPDF for Node.js 무료 체험 시작하기

HTML을 PDF로 변환

Online Demo 코드 예제 모두 보기

import {PdfDocument} from "@ironsoftware/ironpdf";

(async () => {
    // Create a PDF from an HTML string
    const pdf = await PdfDocument.fromHtml("<h1>Hello World</h1>");

    // Export the PDF to a file
    await pdf.saveAs("output.pdf");

    // Advanced Example with HTML Assets
    // Load external HTML assets: Images, CSS, and JavaScript.
    const htmlContentWithAssets = "<img src='icons/iron.png'>";
    const advancedPdf = await PdfDocument.fromHtml(htmlContentWithAssets);

    // Save the PDF with loaded assets
    await advancedPdf.saveAs("html-with-assets.pdf");
})();

import {PdfDocument} from "@ironsoftware/ironpdf";

(async () => {
    // Create a PDF from an HTML string
    const pdf = await PdfDocument.fromHtml("<h1>Hello World</h1>");

    // Export the PDF to a file
    await pdf.saveAs("output.pdf");

    // Advanced Example with HTML Assets
    // Load external HTML assets: Images, CSS, and JavaScript.
    const htmlContentWithAssets = "<img src='icons/iron.png'>";
    const advancedPdf = await PdfDocument.fromHtml(htmlContentWithAssets);

    // Save the PDF with loaded assets
    await advancedPdf.saveAs("html-with-assets.pdf");
})();

NODE.JS에서 IRONPDF 사용하기

Node.js에서 PDF 파일을 생성하는 방법

Curtis Chau

Updated: 2026년 6월 20일

이 글은 IronPDF 의 미묘한 특징들을 심층적으로 탐구하여, 초기 설치 과정부터 실제 시나리오에서의 활용까지 모든 측면을 독자들에게 안내하고자 합니다.

1. Node.js PDF 생성기는 어떻게 사용하나요?

Node.js 용 PDF 생성 라이브러리인 IronPDF 설치합니다.
필요한 종속성을 가져옵니다.
PdfDocument.fromHtml 함수를 사용하여 HTML을 PDF로 렌더링합니다.
PdfDocument.fromUrl 메서드를 사용하여 URL에서 PDF를 생성합니다.
imageToPdf 메서드를 사용하여 이미지를 PDF 파일로 변환합니다.
saveAs 메서드를 사용하여 생성된 PDF 파일을 저장합니다.

2. Node.js 용 IronPDF 살펴보기

Iron Software 의 IronPDF Node.js 용으로 세심하게 제작된 강력한 PDF 라이브러리로, 개발자에게 PDF 파일을 손쉽게 생성할 수 있는 완벽한 기능을 제공합니다. IronPDF 다양한 기능을 자랑하며 문서 생성 및 보고서 작성부터 콘텐츠 렌더링에 이르기까지 폭넓은 사용 사례를 지원하여 다재다능함을 입증합니다. 이 라이브러리의 가장 두드러진 특징 중 하나는 HTML 템플릿과 이미지를 PDF 파일로 매끄럽게 변환하는 놀라운 기능으로, 다양한 콘텐츠 소스를 처리하는 데 있어 라이브러리의 적응성과 효율성을 보여줍니다.

2.1. IronPDF 설치

PDF 생성 작업을 시작하기 전에 먼저 IronPDF 설치해야 합니다. Node.js의 패키지 관리자인 npm 덕분에 과정은 간단합니다. 터미널을 열고 다음 명령어를 실행하세요.

> npm i @ironsoftware/ironpdf

npm i @ironsoftware/ironpdf

이 명령은 IronPDF 패키지를 가져와 설치하여 Node.js 프로젝트에서 사용할 수 있도록 합니다.

IronPDF 라이브러리 사용에 필요한 IronPDF 엔진을 설치하려면 콘솔에서 다음 명령을 실행하십시오.

> npm install @ironsoftware/ironpdf-engine-windows-x64

npm install @ironsoftware/ironpdf-engine-windows-x64

3. 필수 패키지 추가

IronPDF 설치한 후에는 import 문을 사용하여 프로젝트에 필요한 패키지를 포함시켜야 합니다. 이렇게 하면 IronPDF 에서 제공하는 기능에 액세스할 수 있습니다. 다음 예를 생각해 보세요.

import { PdfDocument } from "@ironsoftware/ironpdf";

import { PdfDocument } from "@ironsoftware/ironpdf";

JavaScript

이 import 문은 IronPDF와 함께 PDF 파일을 생성하기 위한 기본 빌딩 블록인 PdfDocument 클래스를 가져옵니다.

4. PDF 파일 생성

이제 프로젝트에 IronPDF 설정되었으므로 PDF 생성기 패키지를 사용하여 PDF 파일을 생성하는 기본 프로세스를 살펴보겠습니다. IronPDF 사용하여 PDF 파일을 생성하는 방법은 여러 가지가 있지만, 이 글에서는 그중 몇 가지를 살펴보겠습니다.

HTML 문자열을 PDF로 변환
PDF URL
이미지를 PDF로 변환

4.1. IronPDF 사용하여 HTML을 PDF 문서로 변환

IronPDF의 뛰어난 기능 중 하나는 HTML을 PDF 파일로 손쉽게 변환할 수 있다는 점입니다. 이 기능은 서버에서 생성된 동적 콘텐츠를 PDF 형식으로 표시하려는 경우에 특히 유용합니다. 다음은 간단한 예입니다.

import { PdfDocument } from "@ironsoftware/ironpdf";

(async () => {
  // Create a PDF from an HTML string
  const pdf = await PdfDocument.fromHtml(
    "<h1>Hello Developers This is an Example PDF created with IronPDF</h1>"
  );

  // Export the PDF to a file
  await pdf.saveAs("output.pdf");
})();

import { PdfDocument } from "@ironsoftware/ironpdf";

(async () => {
  // Create a PDF from an HTML string
  const pdf = await PdfDocument.fromHtml(
    "<h1>Hello Developers This is an Example PDF created with IronPDF</h1>"
  );

  // Export the PDF to a file
  await pdf.saveAs("output.pdf");
})();

JavaScript

이 코드 조각은 Node.js 라이브러리인 IronPDF 사용하여 지정된 HTML 문자열로부터 PDF 문서를 동적으로 생성합니다. IronPDF 패키지에서 PdfDocument 클래스를 가져옵니다. 후속 비동기 함수는 fromHtml 메서드를 사용하여 간단한 헤딩 요소를 기반으로 PDF 문서를 생성합니다. 그런 다음 생성된 PDF를 "output.pdf"라는 파일로 내보내기 위해 saveAs 메서드를 사용합니다.

코드의 비동기적 성질은 async/await 구문을 사용하여 관리되며, PDF 데이터 생성 및 저장 프로세스가 비차단 방식으로 이루어지도록 합니다. 전반적으로, 이 간결한 예시는 IronPDF Node.js 환경에서 PDF 생성 및 조작을 어떻게 간소화하는지 보여줍니다.

산출

Node.js에서 PDF 파일 생성 방법, 그림 1: IronPDF 라이브러리를 사용하여 HTML 문자열에서 생성된 출력 PDF IronPDF 라이브러리를 사용하여 HTML 문자열에서 생성된 PDF 파일을 출력합니다.

4.2. IronPDF 사용하여 URL에서 PDF 파일 생성

Node.js 에서 IronPDF 사용하여 URL에서 PDF 파일을 생성하는 것은 웹 콘텐츠를 프로그래밍 방식으로 PDF 문서로 변환할 수 있는 강력한 기능입니다. 다음은 이를 구현하는 방법을 보여주는 예제 코드 조각입니다.

import { PdfDocument } from "@ironsoftware/ironpdf";

(async () => {
  // URL of the web page to convert to PDF
  const url = "https://google.com";

  // Create a PDF doc from the specified URL
  const pdf = await PdfDocument.fromUrl(url);

  // Save the PDF to a file
  await pdf.saveAs("output_from_url.pdf");
})();

import { PdfDocument } from "@ironsoftware/ironpdf";

(async () => {
  // URL of the web page to convert to PDF
  const url = "https://google.com";

  // Create a PDF doc from the specified URL
  const pdf = await PdfDocument.fromUrl(url);

  // Save the PDF to a file
  await pdf.saveAs("output_from_url.pdf");
})();

JavaScript

이 코드에서:

IronPDF 패키지에서 PdfDocument 클래스가 가져옵니다.
즉시 호출되는 함수 표현식으로 래핑된 비동기 함수 내부에서, PDF로 변환할 웹 페이지의 URL로 url 변수가 정의됩니다.
지정된 URL에서 PDF 문서를 생성하기 위해 fromUrl 메서드를 사용합니다. IronPDF URL에서 콘텐츠를 가져와 PDF 문서로 변환합니다.
마지막으로, "output_from_url.pdf"라는 파일에 생성된 PDF를 저장하기 위해 saveAs 메서드를 사용합니다.

이 예시는 IronPDF 사용하여 URL의 웹 콘텐츠를 PDF 파일로 변환하는 간단한 방법을 보여줍니다. 따라서 동적인 웹 콘텐츠를 PDF 형식으로 보관하거나 공유해야 하는 상황에서 IronPDF는 매우 유용한 도구입니다.

Node.js에서 PDF 파일 생성 방법, 그림 2: IronPDF 라이브러리를 사용하여 URL에서 생성된 출력 PDF IronPDF 라이브러리를 사용하여 URL에서 생성된 PDF 파일을 출력합니다.

4.3. IronPDF 사용하여 이미지에서 PDF 파일 생성하기

IronPDF HTML 외에도 이미지로부터 PDF 파일을 생성하는 기능을 제공합니다. 이 기능은 이미지를 하나의 PDF 문서로 묶어야 하는 경우에 특히 유용합니다. 간단한 예를 살펴보겠습니다.

import { PdfGenerator } from "@ironsoftware/ironpdf";
import fs from "fs";

(async () => {
  // Specify the directory path
  const directoryPath = "./images";

  // Read the contents of the directory
  fs.readdir(directoryPath, (err, files) => {
    if (err) {
      console.error("Error reading directory:", err);
      return;
    }

    // Filter file names to include only .jpg and .jpeg extensions
    const jpegFiles = files.filter(
      (file) =>
        file.toLowerCase().endsWith(".jpg") || file.toLowerCase().endsWith(".jpeg")
    );

    // Construct full file paths for the filtered files
    const filePaths = jpegFiles.map((file) => `${directoryPath}/${file}`);

    // Converts the images to a PDF and save it.
    PdfGenerator.imageToPdf(filePaths).then((returnedPdf) => {
      returnedPdf.saveAs("composite.pdf");
    });

    // Also see PdfDocument.rasterizeToImageFiles() method to flatten a PDF to images or thumbnails
  });
})();

import { PdfGenerator } from "@ironsoftware/ironpdf";
import fs from "fs";

(async () => {
  // Specify the directory path
  const directoryPath = "./images";

  // Read the contents of the directory
  fs.readdir(directoryPath, (err, files) => {
    if (err) {
      console.error("Error reading directory:", err);
      return;
    }

    // Filter file names to include only .jpg and .jpeg extensions
    const jpegFiles = files.filter(
      (file) =>
        file.toLowerCase().endsWith(".jpg") || file.toLowerCase().endsWith(".jpeg")
    );

    // Construct full file paths for the filtered files
    const filePaths = jpegFiles.map((file) => `${directoryPath}/${file}`);

    // Converts the images to a PDF and save it.
    PdfGenerator.imageToPdf(filePaths).then((returnedPdf) => {
      returnedPdf.saveAs("composite.pdf");
    });

    // Also see PdfDocument.rasterizeToImageFiles() method to flatten a PDF to images or thumbnails
  });
})();

JavaScript

이 코드는 Node.js 라이브러리인 IronPDF 사용하여 지정된 디렉터리에 있는 JPEG 이미지 모음을 단일 PDF 문서로 변환합니다. 처음에 코드는 이미지가 포함된 디렉터리 경로를 지정합니다. 그런 다음 fs.readdir 함수를 사용하여 디렉토리의 내용을 읽습니다. 그 후, 파일 이름을 필터링하여 확장자가 ".jpg" 또는 ".jpeg"인 파일만 포함시킵니다.

필터링된 이미지에 대한 전체 파일 경로가 구성되고, 이러한 이미지를 PDF 문서로 변환하기 위해 PdfGenerator.imageToPdf 메서드를 사용합니다. 생성된 PDF 파일은 "composite.pdf"라는 이름으로 저장됩니다. 이 스크립트는 IronPDF 를 사용하여 여러 이미지를 하나의 PDF 파일로 통합 변환하는 간소화된 프로세스를 보여줍니다. 이를 통해 이미지 콘텐츠를 단일 문서로 구성하고 제시해야 하는 상황에 실용적인 솔루션을 제공합니다.

Node.js에서 PDF 파일 생성 방법, 그림 3: IronPDF 라이브러리를 사용하여 이미지에서 생성된 출력 PDF IronPDF 라이브러리를 사용하여 이미지에서 생성된 PDF 출력

5. 결론

Node.js 와 IronPDF 결합하면 동적인 PDF 생성을 위한 무궁무진한 가능성이 열립니다. IronPDF 간단한 텍스트 기반 문서부터 동적 콘텐츠가 포함된 복잡한 보고서에 이르기까지 프로세스를 간소화하고 Node.js 애플리케이션의 기능을 향상시켜 줍니다. HTML을 PDF로 변환하든, 템플릿을 채우든, 이미지를 PDF 파일로 컴파일하든, IronPDF 다양한 PDF 생성 요구 사항을 충족하는 효율적인 솔루션을 제공합니다.

이러한 기능들을 계속 살펴보고 구현해 나가다 보면, IronPDF Node.js 라이브러리가 동 적이고 시각적으로 매력적인 PDF 문서를 생성하는 과정을 간소화해 주는 유용한 개발자 도구라는 것을 알게 될 것입니다.

Node.js 용 IronPDF 사용자에게 무료 평가판을 제공합니다. IronPDF 사용을 시작하려면 이 문서 페이지를 방문하세요. HTML을 PDF로 변환하는 코드 예제와 전체 튜토리얼은 다음 튜토리얼 페이지 에서 확인할 수 있습니다.

Curtis Chau

지금 바로 엔지니어링 팀과 채팅하세요

기술 문서 작성자

커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.

...

더 읽어보기