PDF → HTML 변환기
PDF를 이미지·표·차트와 읽기 순서를 유지한 단일 HTML 파일로 바꾸고, 원하면 번역까지 해주는 스킬입니다.
문서·오피스중급★ 1,323⑂ 212AI 점수 9/10마지막 업데이트: 2026. 8. 8.
무엇을 해주나
PyMuPDF로 PDF의 텍스트 블록·폰트 크기·이미지를 구조적으로 추출한 뒤, 폰트 크기를 기준으로 제목 단계를 추론하고 장식용 이미지를 걸러내어 하나의 자체 완결형 HTML 파일을 만들어 줍니다. 이미지는 압축 후 base64로 인라인되므로 파일 하나만 더블클릭하면 어디서든 열립니다.
핵심은 추출 → 확인 → (번역) → 빌드 → 검증 파이프라인입니다. 빌드 전에 페이지 렌더 PNG를 직접 보고 레이아웃을 파악하고, 완성 후에는 헤드리스 Chrome으로 다시 렌더링해 글꼴 깨짐·잘린 표·누락 이미지를 눈으로 확인합니다.
번역 옵션을 쓰면 페이지를 병렬로 번역하고 용어를 통일하며, 차트 캡션까지 붙여줍니다. 인명·숫자·고유명사는 원문 그대로 유지하는 충실성 규칙이 문서화되어 있습니다.
참고: 스캔 이미지 PDF는
ocrmypdf등으로 OCR을 먼저 해야 하며, 복잡한 다단 표의 격자선은 유지되지 않습니다. 원본과 픽셀 단위로 똑같은 복제본이 아니라 '깔끔하게 재배치된 읽기용 문서'입니다.
이런 분께 추천
- 논문·리포트·백서를 휴대폰이나 브라우저에서 편하게 읽고 싶은 분
- 영문 PDF를 그림·표를 잃지 않고 한국어로 번역해 보고 싶은 분
- 사내 자료를 첨부파일 하나로 공유해야 하는 실무자
- Markdown 텍스트가 아니라 스타일이 살아있는 문서가 필요한 분
활용 예시
- 영문 리서치 리포트 한글화: 50페이지 영문 PDF를 던지고 "차트 그대로 두고 한국어로 번역해줘"라고 하면, 페이지별 병렬 번역 + 용어 통일 후 이미지가 살아있는 한국어 HTML 한 개가 나옵니다.
- 모바일 읽기용 변환: 글자가 작아 읽기 힘든 학술 논문을 HTML로 바꿔 폰 브라우저에서 확대/축소 없이 읽습니다.
- 공유용 단일 파일 만들기: 이미지가 많은 제품 소개서를 base64 인라인 HTML로 만들어 메신저로 파일 하나만 전달합니다.
· · · 설치 가이드 · · ·
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 daymade/claude-code-skills 의 daymade-docs/pdf-to-html 폴더를 내 ~/.claude/skills/pdf-to-html/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/daymade/claude-code-skills.git && mkdir -p ~/.claude/skills && cp -r claude-code-skills/daymade-docs/pdf-to-html ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 사전 준비:
uv(파이썬 실행기)와 Google Chrome 또는 Chromium을 설치합니다. macOS라면brew install uv, Chrome은 공식 사이트에서 받으면 됩니다. - 저장소 클론: 터미널에서
git clone https://github.com/daymade/claude-code-skills.git을 실행합니다. - 스킬 폴더 생성:
mkdir -p ~/.claude/skills - 스킬 복사:
cp -r claude-code-skills/daymade-docs/pdf-to-html ~/.claude/skills/ - 확인: Claude Code를 다시 실행한 뒤 "이 PDF를 HTML로 바꿔줘"라고 요청하면 스킬이 자동으로 호출됩니다.
- 첫 실행: PDF 파일 경로를 함께 알려주세요. 파이썬 패키지(PyMuPDF, Pillow, numpy)는
uv run --with가 알아서 설치하므로 따로 준비할 필요가 없습니다.
GitHub에서 원본 보기 ↗라이선스: MIT