본문으로 건너뛰기
PPDF123

HTML을 PDF로 만들기

HTML을 PDF로는 올린 .html 또는 .htm 파일, 혹은 HTML이 든 ZIP을 WeasyPrint로 PDF로 렌더합니다. JavaScript는 실행되지 않아 스크립트로 만든 페이지는 불완전하게 나옵니다.

여기에 파일을 끌어다 놓거나, 클릭해 고릅니다

HTML, HTM, ZIP 지원 · 파일당 최대 500.0 MB · 한 번에 최대 20개 파일

Ctrl/Cmd+V 또는 클립보드 메뉴로 파일을 붙여넣을 수도 있습니다.

HTML을 PDF로는 WeasyPrint로 렌더합니다. `.html` / `.htm` 파일, 또는 `.html`이 하나 이상 들어 있는 ZIP을 올립니다(아카이브 루트에 `index.html`이 있으면 그것을, 없으면 첫 `.html` 항목을 씁니다). 결과는 업로드한 파일 이름을 따르는 PDF입니다.

`zoom` 필드는 무시됩니다. 헤드리스 Chrome이 없고 JavaScript도 실행하지 않습니다. 외부 이미지, 스타일시트, 글꼴은 공개 웹 주소에서 가져오며(리소스 최대 500개, 개당 64MiB, 요청당 15초), 사설·내부 네트워크 주소는 차단됩니다. ZIP 안의 상대 경로 리소스는 압축을 푼 파일에서 찾습니다.

WeasyPrint가 지원하는 CSS는 인쇄됩니다. 스크립트 중심 앱, 내려받아지지 않는 웹 폰트, 최신 JS 레이아웃은 자주 무너집니다. 암호화된 PDF는 입력이 아닙니다. 이 도구는 HTML에서 시작합니다.

소스가 이미 URL이면 URL을 PDF로를 쓰세요. 소스가 Markdown이면 Markdown을 PDF로(CommonMark를 거쳐 같은 WeasyPrint 단계)를 쓰세요.

단일 업로드는 HTML 파일 하나로 디스크에 쓰여 그대로 렌더됩니다. 주위에 아무것도 덧붙이지 않습니다. 인쇄용 스타일시트도, 페이지 크기도, 글꼴도 없습니다. 페이지 크기와 여백은 `@page` 규칙 같은 직접 쓴 CSS에서, 없으면 WeasyPrint 기본값에서 나옵니다.

ZIP 안에서는 루트에 `index.html`이 없을 때 이름이 `.html`로 끝나는 항목만 후보가 되며, 아카이브 안의 `.htm` 파일은 선택되지 않습니다. 그런 항목이 없는 아카이브는 ZIP에 .html 파일이 있어야 한다는 메시지와 함께 거절되고, 압축 해제 폴더를 벗어나려는 항목 이름(예: `..` 사용)도 거절됩니다.

PDF 이름은 업로드한 파일을 따르므로 `invoice-2041.html`은 `invoice-2041.pdf`를 반환합니다. 렌더링은 기본적으로 180초 뒤에 중단되며, 매우 크거나 가져오기가 느린 페이지는 이 한도에 걸릴 수 있습니다.

기능

  • WeasyPrint. Chromium 아님
  • HTML 또는 ZIP 수락(index.html, 없으면 첫 .html을 렌더)
  • zoom 무시. JavaScript 없음
  • 익명 API: /api/v1/convert/html/pdf

이런 경우에

  • 정적 청구서 HTML을 PDF로 인쇄
  • JS가 필요 없는 CSS 기반 보고서를 렌더
  • 작은 HTML+자산 ZIP을 PDF로 만듦
  • 내보낸 HTML 메일이나 영수증을 고정된 문서로 보관
  • 인쇄용 스타일시트를 내보내기 전에 쪽 나누기가 어떻게 되는지 확인

HTML을 PDF로 변환하려면?

  1. HTML 파일 또는 HTML이 든 ZIP을 업로드합니다.
  2. zoom은 건너뛰세요. 렌더링을 바꾸지 않습니다.
  3. 처리를 누르고 PDF를 내려받습니다.
  4. 글꼴과 쪽 나누기를 확인합니다. JS만으로 만든 페이지는 비어 있거나 깨져 보입니다.
  5. 스타일시트나 이미지가 빠졌다면 ZIP에 HTML 옆에 넣고 상대 경로로 참조하거나, 공개 웹 주소를 가리키세요. 내 컴퓨터의 로컬 파일 경로는 서버에서 쓸 수 없습니다.
  6. 쪽 나누기가 어색한 곳에 걸리면 원본에 CSS 쪽 나누기 규칙을 추가해 다시 렌더하세요. 변환기 자체에는 조정할 레이아웃 설정이 없습니다.

제한과 경계

  • JavaScript, Chrome, zoom 없음
  • WeasyPrint가 지원하는 CSS만
  • 원격 리소스는 공개 웹 주소에서만 불러오며 사설·내부 주소는 차단됨
  • 렌더링은 기본 180초 뒤에 중단됨
  • ZIP 안에서는 `.html` 이름만 일치하고 `.htm`은 아님
  • 기본 페이지 크기나 여백이 적용되지 않으며 레이아웃은 CSS에서 나옴
  • 이 사이트의 업로드 한도는 파일당 500MB이며, 약 95MB를 넘으면 나누어 전송합니다. API 직접 요청 한 건의 본문은 100MB까지입니다.

예시

  • 로컬 CSS가 있는 시맨틱 HTML 편지는 깔끔하게 인쇄되는 경우가 많음
  • 빌드하지 않은 create-react-app의 index.html은 대개 빈 페이지로 인쇄됨
  • `index.html`, `style.css`, `logo.png`가 든 ZIP은 index.html을 렌더하며, 상대 경로의 스타일시트와 로고는 압축을 푼 폴더에서 찾음
  • `pages/a.html`과 `pages/b.html`만 있고 index.html이 없는 ZIP은 둘 다가 아니라 아카이브의 첫 .html 항목만 렌더함

이 도구의 개인정보 안내

파일은 HTTPS로 업로드되며, 서버 메모리 또는 수명이 짧은 임시 디렉터리에서 처리되고, 결과가 준비되면 삭제됩니다. 이후 열람·학습·광고 프로필용 사본은 보관하지 않습니다. 보관 기간과 AdSense 쿠키 고지는 개인정보 처리방침을 참고하세요.

자주 묻는 질문

React 앱이 빈 PDF가 되는 이유는요?
WeasyPrint는 JavaScript를 실행하지 않습니다. 빈 SPA 껍데기가 아니라 정적 HTML을 보내세요.
zoom이 동작하나요?
아닙니다. 변환 함수는 매개변수를 받지 않습니다.
ZIP은 어떻게 동작하나요?
아카이브 루트에 index.html이 있으면 그 파일을 렌더하고, 없으면 첫 .html 항목을 렌더합니다.
Chrome의 PDF로 인쇄와 같은가요?
아닙니다. WeasyPrint의 HTML/CSS 엔진입니다.
용지 크기와 여백은 어떻게 정하나요?
HTML의 CSS에서 @page 규칙으로 정합니다. 이 페이지에는 용지나 여백 필드가 없고, Markdown을 PDF로와 달리 기본 스타일시트를 넣지도 않으므로 CSS가 정하지 않은 것은 렌더러에 맡겨집니다.
변환기가 내 컴퓨터의 이미지를 불러올 수 있나요?
로컬 경로로는 안 됩니다. 이미지를 ZIP에 묶고 상대 경로로 참조하거나 공개 웹 주소를 쓰세요. 사설·내부 네트워크 주소는 차단됩니다.
ZIP이 거절된 이유는요?
.html로 끝나는 파일이 없거나(아카이브 안의 .htm 파일은 해당하지 않음), 항목 이름이 압축 해제 폴더를 벗어나려 합니다. 항목 이름을 .html로 바꾸고 상위 디렉터리 경로 없이 다시 압축하세요.
실제 웹 페이지에는 어떤 도구를 쓰나요?
URL을 PDF로가 공개 주소를 대신 가져옵니다. HTML을 PDF로는 이미 파일로 가지고 있는 마크업용입니다.

최종 업데이트:

코드에서 호출하기

이 사이트의 도구는 모두 일반 REST 엔드포인트입니다. 익명 사용에는 계정이나 API 키가 필요 없습니다. 브라우저뿐 아니라 개발자와 AI 에이전트도 그대로 쓸 수 있습니다.

curl -X POST "https://pdf123.xyz/api/v1/convert/html/pdf" \
  -F "[email protected]" \
  -o output.pdf

Model Context Protocol을 쓰는 에이전트 클라이언트용 MCP 도구로도 제공합니다(JSON-RPC 2.0, POST /mcp). 전체 API 문서

AI 에이전트에서 사용하기

스킬

이 스킬을 설치하면 Claude Code, Codex, Cursor 등 AI 에이전트가 'HTML을 PDF로' 작업을 대신 실행합니다: /skills/pdf123-html-to-pdf.md

전체 에이전트 스킬

파일은 이번 처리에만 쓰이며, 끝나면 자동으로 삭제됩니다.