본문으로 건너뛰기
PPDF123

PDF를 HTML 파일로 만들기

PDF를 HTML로는 Poppler의 pdftohtml로 PDF를 변환해 HTML 페이지와 그 이미지를 묶은 ZIP을 줍니다. 깔끔한 웹 마크업이 아니라 레이아웃 내보내기이며 OCR은 하지 않습니다.

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

PDF 지원 · 파일당 최대 500.0 MB · 한 번에 최대 20개 파일

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

PDF를 HTML로는 Poppler `pdftohtml -c`를 실행하고, 그 도구가 출력 디렉터리에 쓴 것을 모두 ZIP으로 묶습니다. 다운로드는 단일 `.html` 파일이 아니라 `{base}ToHtml.zip`입니다. 브라우저급 복잡한 CSS가 목표가 아니라, Poppler의 HTML과 이미지 덤프입니다.

폼 필드는 없습니다. 모든 페이지가 변환됩니다. `pdftohtml`이 아무것도 쓰지 않으면 API는 빈 ZIP이 아니라 내부 오류를 반환합니다.

OCR이 아닙니다. 이미지뿐인 스캔은 HTML 패키지 안의 그림이 될 뿐 선택 가능한 텍스트가 되지 않습니다. 비밀번호로 보호된 파일은 이 페이지에서 비밀번호를 입력하면 자동으로 해제됩니다. API 호출자는 먼저 비밀번호 해제를 실행하세요.

글만 필요하다면 PDF를 텍스트로가 더 작습니다. CMS에 맞는 기사가 필요하다면 PDF를 Markdown으로가 더 가깝습니다.

ZIP 안에 든 것은, 2페이지 텍스트 PDF에 Poppler의 `pdftohtml -c`를 실행한 결과로 보면 이렇습니다. 프레임셋일 뿐인 `in.html`, 페이지마다 링크가 하나씩 있는 `in_ind.html` 색인, 페이지마다 HTML 파일 하나(`in-1.html`, `in-2.html`), 페이지마다 배경 PNG 하나(`in001.png`, `in002.png`)입니다. 이름은 업로드한 파일 이름에서 시작합니다. 업로드 이름을 딴 파일을 열면 왼쪽에 페이지 목록이 있는 프레임셋이 보이고, 페이지 파일 하나를 직접 열어도 됩니다. Poppler 버전이 다르면 이름이나 배치가 조금 다를 수 있습니다.

각 페이지 파일은 텍스트의 모든 줄을 절대 좌표로 배치합니다. 픽셀 단위 `top`, `left` 값을 가진 별도 문단들이 페이지 배경 이미지 위에 올라갑니다. 그 실행에서 612×792포인트 페이지는 포인트 크기의 1.5배인 918×1188픽셀 블록이 되었고, 텍스트는 그림이 아니라 선택할 수 있는 실제 HTML 텍스트로 남았습니다. 모든 줄이 픽셀 위치에 고정되므로 결과는 PDF처럼 보이지만 좁은 화면에서 다시 흐르지 않고 편집하기도 불편합니다.

이것은 깔끔한 웹 기사가 아니라 고정 레이아웃 사본으로 이해하세요. 제목, 목록, 문단은 의미 있는 HTML 요소로 다시 만들어지지 않습니다. CMS에 넣을 수 있는 콘텐츠를 원하면 대신 Markdown으로 변환하세요. 사람이 편집할 문서를 원하면 PDF를 Word로를, 글만 원하면 PDF를 텍스트로를 쓰세요.

스캔한 PDF에는 변환할 텍스트 레이어가 없습니다. 각 페이지가 이미지이므로 HTML 페이지는 그 그림을 감쌀 뿐이고 선택할 글은 없습니다. 글이 필요하면 먼저 OCR을 실행하세요. 다만 OCR은 Markdown을 반환하며, 이 도구에 다시 넣을 수 있는 PDF를 반환하지는 않습니다.

반대 방향은 HTML을 PDF로이며, 이는 HTML 페이지에서 PDF를 만들 뿐 이 변환을 되돌리지는 않습니다.

기능

  • Poppler `pdftohtml -c`로 HTML과 리소스를 ZIP으로
  • 페이지마다 HTML 파일 하나와 색인, 프레임셋 페이지
  • 텍스트는 각 페이지의 배경 이미지 위에 절대 위치로 배치됨
  • 페이지 범위·테마 옵션 없음
  • OCR 아님. 스캔은 패키지 안에서도 이미지로 남음
  • 익명 API: /api/v1/convert/pdf/html

이런 경우에

  • 텍스트 레이어가 있는 PDF에서 대략적인 HTML 덤프를 얻음
  • pdftohtml이 추출하는 내장 페이지 이미지를 가져옴
  • 맞춤 파이프라인 전에 Poppler가 파일을 어떻게 보는지 확인
  • PDF 뷰어 없이 브라우저에서 PDF의 고정 레이아웃 사본을 읽음
  • 자체 스크래핑이나 변환 스크립트의 출발점으로 페이지별 텍스트 위치를 모음

PDF를 HTML로 변환하려면?

  1. 선택 가능한 텍스트가 있는 페이지의 PDF를 업로드합니다. 스캔은 이미지로만 변환됩니다. 이 페이지에 변환 옵션은 없습니다.
  2. 처리를 누르고 `{name}ToHtml.zip`을 내려받은 뒤, 페이지 파일과 이미지가 함께 있도록 별도 폴더에 압축을 풉니다.
  3. 브라우저에서 메인 HTML 파일을 열어 프레임셋을 보거나, `-1.html` 같은 페이지 파일 하나를 엽니다.
  4. 페이지를 PDF와 비교합니다. 줄이 제자리에 있는지, 배경 이미지가 불러와지는지 확인하세요. 이미지가 보이지 않으면 PNG 파일이 HTML 옆에 있는지 확인하세요.
  5. 글이 빠지거나 레이아웃을 쓸 수 없다면 글만 필요할 때는 PDF를 텍스트로, 구조가 필요할 때는 PDF를 Markdown으로를 쓰고, 파일이 스캔이라면 OCR을 실행하세요.

제한과 경계

  • 산출물은 단일 HTML이 아니라 ZIP
  • Chromium 인쇄도, 태그된 PDF의 HTML 내보내기도 아님
  • pdftohtml이 아무것도 내지 않으면 204가 아니라 오류
  • 고정 레이아웃. 다시 흐르지 않으며 의미 있는 제목이나 목록도 없음
  • 모든 페이지가 변환되며 페이지 범위가 없음
  • 스캔은 이미지만 나옴
  • 이 사이트의 업로드 한도는 파일당 500MB이며, 약 95MB를 넘으면 나누어 전송합니다. API 직접 요청 한 건의 본문은 100MB까지입니다.

예시

  • 테스트 실행에서 2페이지 텍스트 PDF는 `in.html`(프레임셋), `in_ind.html`(페이지 목록), `in-1.html`과 `in-2.html`(페이지별), `in001.png`와 `in002.png`(배경)를 만들어 냈음
  • 그 실행에서 첫 페이지 파일은 각 텍스트 줄을 절대 위치의 문단으로 담았으며, 예를 들어 위에서 119픽셀, 왼쪽에서 108픽셀 위치에 918×1188픽셀 배경 이미지 위로 놓였음
  • 스캔만 있는 PDF는 대부분 그 페이지 이미지를 감싸는 HTML이 나옴

이 도구의 개인정보 안내

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

자주 묻는 질문

결과가 ZIP인 이유는요?
pdftohtml은 HTML과 추출한 이미지를 폴더에 씁니다. 서버가 그 폴더를 ZIP으로 묶습니다.
HTML이 PDF 레이아웃과 같나요?
Poppler의 -c 모드가 하는 만큼만 같습니다. 다단 잡지와 벡터가 많은 문서는 자주 어긋납니다.
스캔을 HTML 텍스트로 변환할 수 있나요?
없습니다. 이 경로는 OCR을 하지 않습니다. 글이 필요하면 OCR → Markdown을 쓰세요.
브라우저에서 실행되나요?
아닙니다. 서버가 pdftohtml을 호출합니다.
압축을 푼 뒤 어느 파일을 먼저 열어야 하나요?
업로드한 파일 이름이 붙은 HTML 파일을 열면 왼쪽에 페이지 목록이 있는 프레임셋이 나옵니다. 또는 업로드 이름에 페이지 번호가 붙은 페이지 파일을 직접 열어도 됩니다. 배경 이미지가 불러와지도록 모든 파일을 한 폴더에 두세요.
페이지는 PDF처럼 보이는데 텍스트가 다시 흐르지 않는 이유는요?
각 텍스트 줄이 페이지 배경 이미지 위에 절대 픽셀 좌표로 배치되어 레이아웃이 고정됩니다. 그래서 PDF와 비슷하게 유지되고, 또 그래서 작은 화면에 맞게 바뀌지 않습니다.
HTML의 텍스트는 실제 텍스트인가요, 그림인가요?
텍스트 레이어가 있는 PDF라면 문단 요소 안의 실제 텍스트이므로 브라우저에서 선택하고 복사하고 검색할 수 있습니다. 스캔한 PDF에는 텍스트 레이어가 없어서 페이지가 이미지로만 나옵니다.
모든 것이 든 HTML 파일 하나를 받을 수 있나요?
없습니다. 출력은 항상 여러 파일의 ZIP입니다. 텍스트 파일 하나가 필요하면 PDF를 텍스트로나 PDF를 Markdown으로를 쓰세요.
이 도구와 PDF를 Word로 중 무엇을 써야 하나요?
브라우저에서 열 수 있고 PDF처럼 보이는 것을 원하면 PDF를 HTML로를 쓰세요. 사람이 내용을 편집해야 하면 PDF를 Word로를 쓰세요. 그 도구는 줄을 좌표에 고정하는 대신 편집기를 위해 문단을 다시 만듭니다.

최종 업데이트:

코드에서 호출하기

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

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

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

AI 에이전트에서 사용하기

스킬

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

전체 에이전트 스킬

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