명령줄로 HTML을 PDF로 변환 — 서버 일괄 변환기

서버에 아카이빙, 오프라인 배포 또는 최종 사용자에게 인쇄 가능한 문서를 전달하는 워크플로를 위해 PDF로 변환해야 하는 수백 개의 HTML 파일이나 저장된 웹 페이지가 있습니다. 각 파일을 브라우저에서 열어 PDF로 인쇄하는 것은 확장성이 없습니다. Total HTML Converter X는 GUI 없이, 브라우저 설치 없이 명령줄에서 HTML 파일을 PDF로 일괄 변환합니다. Windows 서버에 설치하고 스크립트 또는 ActiveX를 통해 호출하면 무인으로 실행됩니다.

HTML vs PDF: 왜 변환해야 하는가?

HTML은 웹 브라우저용으로 설계된 마크업 언어입니다. HTML 파일은 오프라인에서 사용할 수 없는 외부 스타일시트, 이미지, 스크립트를 참조할 수 있습니다. 렌더링은 브라우저 엔진, 설치된 글꼴, 화면 크기에 따라 달라집니다. Chrome에서 인쇄한 HTML 페이지는 Firefox나 Edge에서 인쇄한 같은 페이지와 다르게 보일 수 있습니다.

PDF는 모든 기기에서 동일하게 보이는 고정 레이아웃 형식입니다. 글꼴, 이미지, 레이아웃을 의도한 대로 정확하게 보존합니다. PDF 파일은 비밀번호로 보호하고, 디지털 서명하고, 편집이나 인쇄를 제한할 수 있습니다. 인터넷 연결 없이 모든 브라우저, 모바일 OS, 데스크톱 운영 체제에서 기본적으로 열립니다.

명령줄에서 HTML을 PDF로 변환하는 방법

1단계. Total HTML Converter X 설치

위의 링크에서 설치 프로그램을 다운로드하고 Windows 서버 또는 워크스테이션에서 실행합니다. 설치는 1분 이내에 완료됩니다. 브라우저나 Microsoft Office 설치는 필요하지 않습니다 — 변환기는 HTML 태그, CSS 1/2 스타일, 임베디드 이미지를 처리하는 자체 렌더링 엔진을 사용합니다.

2단계. 명령 프롬프트 열기

cmd.exe 또는 PowerShell을 엽니다. 변환기 실행 파일은 설치 폴더(일반적으로 C:\Program Files\CoolUtils\TotalHTMLConverterX\)에 있는 HTMLConverter.exe입니다. 시스템 PATH에 추가하거나 명령에서 전체 경로를 사용하십시오.

3단계. 기본 변환 실행

가장 간단한 명령은 폴더의 모든 HTML 파일을 PDF로 변환합니다:

HTMLConverter.exe C:\Pages\*.html C:\Output\ -c PDF

이 명령은 C:\Pages\의 모든 .html 파일을 처리하고 결과 PDF를 C:\Output\에 저장합니다. 각 HTML 파일은 같은 기본 이름으로 하나의 PDF를 생성합니다.

4단계. 보안 및 서식 옵션 추가

추가 플래그로 PDF 출력을 제어합니다:

HTMLConverter.exe C:\Pages\*.html C:\Output\ -c PDF -OwnerPassword admin123 -NoPrint -NoCopy

• -OwnerPassword admin123 — 권한을 제어하는 PDF 소유자 비밀번호 설정
• -UserPassword open456 — PDF를 열 때 필요한 비밀번호 설정
• -NoPrint — 출력 PDF에서 인쇄 비활성화
• -NoCopy — 텍스트 선택 및 복사 방지
• -Watermark "CONFIDENTIAL" — 모든 페이지에 텍스트 워터마크 적용
• -PageNum — 바닥글에 페이지 번호 추가
• -log C:\Logs\html2pdf.log — 확인용 변환 로그 작성

5단계. .bat 파일로 자동화

명령을 .bat 파일에 저장하고 Windows 작업 스케줄러로 예약합니다:

@echo off
"C:\Program Files\CoolUtils\TotalHTMLConverterX\HTMLConverter.exe" C:\Incoming\*.html C:\Archive\PDF\ -c PDF -OwnerPassword secret -NoPrint -log C:\Logs\html2pdf.log

이렇게 하면 매일 밤(또는 설정한 간격으로) 변환이 실행되고 결과를 확인할 수 있는 로그 파일이 기록됩니다.

ActiveX / COM 통합

Total HTML Converter X에는 완전한 ActiveX 인터페이스가 포함되어 있습니다. .NET, VBScript, PHP, Python, Ruby, ASP 등 모든 COM 호환 환경에서 변환기를 호출할 수 있습니다. 이를 통해 명령줄 프로세스를 별도로 실행하지 않고도 자체 웹 애플리케이션, 인트라넷 포털 또는 문서 워크플로에 HTML-to-PDF 변환을 내장할 수 있습니다.

예제 (C#/.NET):

HTMLConverterX Cnv = new HTMLConverterX();
Cnv.Convert("C:\\Pages\\report.html", "C:\\Output\\report.pdf", "-c PDF -log c:\\Logs\\html.log");

예제 (PHP):

$c = new COM("HTMLConverter.HTMLConverterX");
$c->convert("C:\\Pages\\report.html", "C:\\Output\\report.pdf", "-c PDF -log c:\\Logs\\html.log");

동일한 호출이 ASP.NET, VBScript, Python, Ruby, Perl, JavaScript(Windows Script Host)에서도 작동합니다. 웹 애플리케이션에서 업로드된 HTML 파일을 수신하고 실시간으로 PDF를 사용자에게 반환할 수 있습니다.

온라인 변환기 vs Total HTML Converter X

HTML을 PDF로 명령줄 변환이 필요한 경우

• 보고서 생성. 웹 애플리케이션이 HTML 보고서를 생성합니다. Total HTML Converter X는 서버 측에서 다운로드 또는 이메일 전달을 위해 이를 PDF로 변환합니다 — 브라우저 렌더링 차이 없이, 수동 내보내기 없이.
• 웹 페이지 아카이빙. 법적 또는 규정 준수 기록으로 웹 페이지를 보존해야 하는 조직은 저장된 HTML 파일을 PDF로 변환합니다. 고정 레이아웃 PDF는 외부 리소스에 의존하지 않고 페이지를 그대로 캡처합니다.
• 청구서 및 영수증 생성. 전자상거래 플랫폼과 청구 시스템은 HTML 템플릿으로 청구서를 생성합니다. 변환기는 단일 명령으로 비밀번호 보호 및 워터마크가 포함된 인쇄용 PDF로 변환합니다.
• 문서 포털 전달. 인트라넷 포털이 콘텐츠를 HTML로 저장합니다. 사용자가 인쇄 가능한 버전을 요청하면 서버가 ActiveX를 통해 HTML을 PDF로 즉시 변환하고 결과를 브라우저로 스트리밍합니다.
• 서버에서 브라우저 종속성 제거. HTML-to-PDF 변환을 위해 서버에서 전체 브라우저를 실행하는 것은 리소스가 많이 필요하고 불안정합니다. Total HTML Converter X는 가벼운 명령줄 도구로 브라우저 종속성을 완전히 대체합니다.

Total HTML Converter X를 선택하는 이유

브라우저 불필요

변환기는 자체 렌더링 엔진을 사용하여 HTML과 CSS를 구문 분석합니다. 서버에 Chrome, Firefox 또는 기타 브라우저를 설치할 필요가 없습니다. 이를 통해 브라우저 업데이트 문제를 제거하고, 서버 공간을 줄이며, 헤드리스 브라우저 자동화의 불안정성을 방지합니다.

진정한 서버 애플리케이션

Total HTML Converter X는 무인 사용을 위해 설계되었습니다. GUI 창, 대화 상자, 확인 프롬프트가 없습니다. 명령줄 또는 서비스의 일부로 조용히 실행됩니다 — 프로덕션 서버에 필요한 바로 그 방식입니다.

완전한 PDF 제어

비밀번호 설정, 권한 제한, 워터마크 추가, 페이지 번호 삽입, 디지털 서명 추가, 머리글과 바닥글 사용자 지정, 용지 크기와 여백 제어 — 모두 명령줄에서 가능합니다. 모든 옵션은 명령줄 플래그 또는 ActiveX 매개변수로 사용할 수 있습니다.

PDF뿐만이 아닙니다

같은 명령줄 도구로 HTML을 DOC, XLS, TIFF, JPEG, RTF, TXT 등으로 변환할 수 있습니다. 하나의 설치로 모든 HTML 변환 요구 사항을 충족합니다. -c PDF를 -c TIFF로 변경하면 동일한 일괄 처리 및 자동화 기능으로 TIFF 출력을 얻을 수 있습니다.

Windows 7/8/10/11 • Server 2008/2012/2016/2019/2022

서버용 HTML 변환기 고객 리뷰 2026

평가하기고객 리뷰를 바탕으로 4.7/5로 평가됨

string src="C:\\test\\Source.HTML";
string dest="C:\\test\\Dest.PDF";

HTMLConverterX Cnv = new HTMLConverterX();
Cnv.Convert(src, dest, "-c PDF -log c:\\test\\HTML.log");

MessageBox.Show("변환 완료!");

dim C
Set C=CreateObject("HTMLConverter.HTMLConverterX")
C.Convert "c:\\source.HTML", "c:\\dest.JPG", "-cJPG -log c:\\html.log"
C.Convert "https://www.coolutils.com/", "c:\\URL Page.PDF", "-cPDF -log c:\\html.log"
set C = nothing

dim C
Set C=CreateObject("HTMLConverter.HTMLConverterX")
Response.Clear
Response.AddHeader "Content-Type", "binary/octet-stream"
Response.AddHeader "Content-Disposition", "attachment; filename=test.pdf"
Response.BinaryWrite
  c.ConvertToStream("C:\\www\\ASP\\Source.html", "C:\\www\\ASP", "-cpdf  -log c:\\html.log")
set C = nothing

예제 PHP:
$src="C:\\test\\test.html";
$dest="C:\\test\\test.pdf";
if (file_exists($dest)) unlink($dest);
$c= new COM("HTMLConverterPro.HTMLConverterX");
$c->convert($src,$dest, "-c pdf -log c:\\HTML.log");
if (file_exists($dest)) echo "OK"; else echo "실패:".$c->ErrorMessage;

require 'win32ole'
c = WIN32OLE.new('HTMLConverterPro.HTMLConverterX')

src="C:\\test\\test.html";
dest="C:\\test\\test.tiff";

c.convert(src,dest, "-c TIFF -log c:\\test\\HTML.log");

if not File.exist?(dest)
  puts c.ErrorMessage
end

import win32com.client
import os.path

c = win32com.client.Dispatch("HTMLConverterPro.HTMLConverterX")

src="C:\\test\\test.eml";
dest="C:\\test\\test.tiff";

c.convert(src, dest, "-c TIFF -log c:\\test\\HTML.log");

if not os.path.exists(file_path):
  print(c.ErrorMessage)

uses Dialogs, Vcl.OleAuto;

var
  c: OleVariant;
begin
  c:=CreateOleObject('HTMLConverterPro.HTMLConverterX');
  C.Convert('c:\\test\\source.html', 'c:\\test\\dest.tiff', '-c TIFF -log c:\\test\\HTML.log');
  IF c.ErrorMessage<> Then
    ShowMessage(c.ErrorMessage);
end;

var c = new ActiveXObject("HTMLConverterPro.HTMLConverterX");
c.Convert("C:\\test\\source.html", "C:\\test\\dest.pdf", "-c PDF");
if (c.ErrorMessage!="")
  alert(c.ErrorMessage)

use Win32::OLE;

my $src="C:\\test\\test.html";
my $dest="C:\\test\\test.tiff";

my $c = CreateObject Win32::OLE 'HTMLConverterPro.HTMLConverterX';
$c->convert($src,$dest, "-c TIFF  -log c:\\test\\HTML.log");
print $c->ErrorMessage if -e $dest;