
HTML을 PDF로 변환하려면 Node.js SDK를 사용하세요.
HTML 파일 또는 웹페이지를 PDF로 변환하는 것은 인쇄 가능한 문서를 생성하고 레이아웃을 보존하며 휴대 가능한 형식으로 콘텐츠를 아카이브하는 데 필수적입니다. Node.js용 GroupDocs.Conversion Cloud SDK를 사용하면 제3자 도구나 브라우저 종속성 없이 REST API를 통해 이 프로세스를 자동화할 수 있습니다.
이 기사에서는 다음을 배우게 됩니다:
🌐 Node.js용 HTML을 PDF로 변환하는 API
The GroupDocs.Conversion Cloud SDK for Node.js는 디자인, 레이아웃 및 임베디드 미디어를 유지하면서 HTML을 PDF 형식으로 고품질, 확장 가능한 변환을 가능하게 합니다.
📦 SDK를 설치하십시오
npm을 사용하여 설치:
npm install groupdocs-conversion-cloud --save
당신의 개인화된 클라이언트 ID와 클라이언트 비밀번호가 GroupDocs Cloud Dashboard에 있는지 확인하세요. 추가 세부정보는 이 tutorial을 방문하는 것을 고려할 수 있습니다.
🚀 Node.js를 사용하여 HTML을 PDF로 변환하기
다음은 Node.js를 사용하여 PDF 문서를 HTML로 변환하는 단계별 가이드입니다:
📌 Step 1: SDK 가져오기 및 API 구성:
const { Configuration, ConvertApi, FileApi, UploadFileRequest, ConvertSettings, ConvertDocumentRequest } = require("groupdocs-conversion-cloud");
const config = new Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
const convertApi = new ConvertApi(config);
const fileApi = new FileApi(config);
📌 Step 2: 클라우드 스토리지에 입력 HTML 파일 업로드:
const fs = require("fs");
const uploadRequest = new UploadFileRequest("input.html", fs.createReadStream("input.html"));
await fileApi.uploadFile(uploadRequest);
📌 Step 3: HTML을 PDF로 변환하는 옵션 설정:
const settings = new ConvertSettings();
settings.filePath = "input.html";
settings.format = "pdf";
settings.outputPath = "converted/output.pdf";
const request = new ConvertDocumentRequest(settings);
await convertApi.convertDocument(request);
console.log("✅ The HTML successfully converted to PDF.");
// 더 많은 예제는 https://github.com/groupdocs-conversion-cloud/groupdocs-conversion-cloud-dotnet 에서 확인하세요.
// API 자격 증명을 가져오세요.
string clientId = "XXXXXX-XXXXXXXXX-4088-9ca0-55c38f4b7f22";
string clientSecret1 = "XXXXXXXXXXXXXXXXXXXX";
// Configuration 클래스의 인스턴스를 생성하고 클라이언트 ID 및 클라이언트 비밀번호로 초기화합니다.
Configuration configuration = new Configuration(clientId, clientSecret);
// API 기본 URL을 정의하여 온라인에서 PDF를 HTML로 변환합니다.
configuration.setApiBaseUrl("https://api.groupdocs.cloud");
// ConvertApi의 Configuration 객체로 인스턴스를 초기화합니다.
ConvertApi convertApi = new ConvertApi(configuration);
ConvertSettings settings = new ConvertSettings();
settings.setStorageName("internal");
settings.setFilePath("input.html");
settings.setFormat("PDF");
settings.setOutputPath("resultant.pdf");
// HTML을 PDF 형식으로 변환하려면 ConvertDocument 메서드를 사용하세요.
ConvertDocumentRequest request = new ConvertDocumentRequest(settings);
List<StoredConvertedResult> response = convertApi.convertDocument(request);
// Check the response and print success message
if (response != null && response.equals("OK")) {
System.out.println("The HTML file is successfully converted PDF! The Resultant PDF file is saved at: " + response.getFilePath());
}

Image:- HTML을 PDF로 변환하는 미리보기.
위 예제에서 생성된 샘플 PDF 파일을 resultant.pdf에서 다운로드하세요.
💻 HTML을 PDF로 변환하기 cURL 사용하기
CLI를 선호하나요? GroupDocs.Conversion Cloud API 엔드포인트를 사용하여 cURL로 HTML을 PDF로 변환할 수도 있습니다.
- ✅ 이 방법은 자동화 파이프라인 및 스크립트 기반 변환에 이상적입니다.
1단계: JWT 액세스 토큰 받기
curl -v "https://api.groupdocs.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET" \
-H "Content-Type: application/x-www-form-urlencoded"
2단계: HTML을 PDF로 변환
curl -v "https://api.groupdocs.cloud/v2.0/conversion" \
-X POST \
-H "accept: application/json" \
-H "authorization: Bearer {accessToken}" \
-H "Content-Type: application/json" \
-d "{ \"StorageName\": \"default\", \"FilePath\": \"{sourcePDF}\", \"Format\": \"html\", \"OutputPath\": \"{finalOutput}\"}"
sourceFile, resultantFile, and accessToken을 실제 값으로 교체하십시오.
- 이제 로컬 드라이브에 PDF를 저장하기 위해 다음 cURL 명령어를 사용하는 것을 고려할 수 있습니다:
curl -v "https://api.groupdocs.cloud/v2.0/conversion" \
-X POST \
-H "accept: application/json" \
-H "authorization: Bearer {accessToken}" \
-H "Content-Type: application/json" \
-d "{ \"StorageName\": \"default\", \"FilePath\": \"{sourceFile}\", \"Format\": \"html\"}" \
-o "myOutput.html"
🧪 무료 HTML을 PDF로 변환기 온라인 사용해 보기
빠르고 코드 없는 솔루션이 필요하신가요? HTML to PDF Converter를 사용하여 웹 콘텐츠를 즉시 변환하세요.

✅ 결론
GroupDocs.Conversion Cloud SDK for Node.js를 사용하면 HTML을 PDF로 신속하고 신뢰성 있게 변환할 수 있습니다. 이는 문서 자동화 기능을 구축하거나 스타일이 적용된 HTML 콘텐츠를 PDF로 내보내는 개발자에게 이상적입니다.
당신이 이것을 Node.js 백엔드에 포함시키든 cURL을 통해 사용하든, 이 API는 유연성과 제어를 제공합니다.
🔗 유용한 리소스
📚 추천 기사
다음 기사를 탐색하는 것을 추천합니다: