본문으로 건너뛰기
PPDF123

PDF를 Markdown 형식으로 만들기

PDF를 Markdown으로는 PDF에 있는 글을 .md 파일로 바꾸며, 제목·문단·목록은 감지되는 범위에서 반영합니다. OCR은 하지 않으므로 스캔한 페이지는 비어서 나옵니다.

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

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

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

PDF를 Markdown으로는 pdf-inspector로 파일에 이미 있는 텍스트를 읽어 `.md` 다운로드(`text/markdown`)를 반환합니다. 목표는 제목, 문단, 목록이며 픽셀 단위 레이아웃이 아닙니다.

OCR을 하지 않습니다. 이미지만 있는 페이지는 종종 비어서 나옵니다. 스캔은 OCR → Markdown을 쓰세요. 그 도구는 이미 `.md`를 반환하며 픽셀을 보는 도구입니다.

읽기 순서가 다단 시각 레이아웃과 다를 수 있습니다. 머리글이 페이지마다 반복될 수 있으니 편집기에서 지우세요. PDF에서 이미지였던 수식은 LaTeX가 되지 않습니다. 코드 목록은 들여쓰기를 잃는 경우가 많습니다.

docs-as-code, Git 차이 비교, 텍스트가 필요한 파이프라인을 위한 변환기입니다. 인쇄 레이아웃이 기록이라면 PDF를 보관하세요. 추출한 글에도 저작권은 여전히 적용되므로, 텍스트로 다시 게시해도 되는 파일만 변환하세요.

비밀번호로 보호된 파일은 이 페이지에서 비밀번호를 입력하면 자동으로 해제됩니다. API 호출자는 먼저 비밀번호 해제를 실행하세요. Markdown을 열어 커밋하기 전에 제목 수준을 고치세요. 이 사이트의 Markdown을 PDF로는 반대 방향이며, 왕복해도 원래 레이아웃은 복원되지 않습니다.

업로드는 일시적입니다. 문서의 Markdown 보관함을 만들어 두지 않습니다.

로컬 서버에서 출력이 어떻게 보였는지입니다. 워드 프로세서에서 내보낸 PDF에 제목 하나, 문단 하나, 제목 둘, 두 항목의 글머리 목록, 세 행의 표가 있었는데, 결과는 `# Annual Report`, 문단, `## Findings`, `- First item`과 `- Second item`, `## Numbers`, 그리고 `|Year|Revenue|` 머리글 행과 데이터 두 행이 있는 파이프 표로 돌아왔습니다. 제목, 목록, 단순한 표가 살아남았습니다. 목록 다음 줄은 빈 줄 없이 곧바로 다음 제목으로 이어졌으니, 게시하기 전에 결과를 훑어보세요.

텍스트가 고정폭 글꼴인 PDF(일반 텍스트 파일을 PDF로 바꾼 것)는 제목처럼 보이던 첫 줄이 `#` 제목이 아니라 펜스 안에 들어간 채, 하나의 펜스 코드 블록으로 돌아왔습니다. 코드, 로그, 타자기 스타일 문서의 PDF에서는 이런 결과를 예상하세요. 문단을 원한다면 펜스를 지우거나 옮기세요.

이미지를 PDF로로 그림 세 장에서 만든 이미지뿐인 PDF는 `text/markdown` 본문이 0바이트인 HTTP 200을 반환했습니다. 그러므로 빈 다운로드는 변환이 실패했다는 뜻이 아니라 파일에 텍스트 레이어가 없다는 뜻입니다. PDF가 아닌 파일은 `invalid_pdf`와 함께 400을, 암호화된 파일은 `password_required`와 함께 400을 반환합니다.

이웃 도구를 고르는 법입니다. Markdown 표시 없이 글만 원하면 PDF를 텍스트로를, 표는 PDF를 CSV로를, 스캔은 OCR을 쓰세요. 대상이 저장소, 정적 사이트 생성기, 프롬프트처럼 페이지 기하보다 제목과 목록이 중요한 곳이면 PDF를 Markdown으로를 쓰세요.

다운로드 이름은 업로드한 파일을 따르므로 `doc.pdf`는 `doc.md`를 반환했습니다.

기능

  • pdf-inspector로 PDF 네이티브 텍스트를 Markdown으로 추출
  • OCR 없음. 스캔은 OCR 도구를 사용
  • 다운로드는 `text/markdown`, 파일 이름은 `.md`
  • 익명 API: /api/v1/convert/pdf/markdown

이런 경우에

  • PDF README를 Git 저장소로 옮김
  • 기사 본문을 프롬프트 파이프라인에 넘김
  • PDF 브리프에서 웹 카피를 초안으로 작성
  • 내보낸 정책 문서를 Markdown으로 바꿔, 버전 사이에 어느 문장이 바뀌었는지 diff로 정확히 확인
  • 긴 보고서의 텍스트를 제목과 목록을 이해하는 노트 도구로 가져옴

PDF를 Markdown으로 변환하려면?

  1. 텍스트 기반 PDF를 우선하세요. 스캔은 대신 OCR → Markdown을 쓰세요.
  2. PDF를 올리고 처리를 누릅니다.
  3. `.md` 파일을 내려받습니다.
  4. 편집기에서 제목 수준, 반복되는 머리글, 표를 고칩니다.
  5. 다운로드가 비어 있으면 PDF에 텍스트 레이어가 없는 것입니다. 다시 시도하지 말고 OCR로 바꾸세요.
  6. 제목 앞에 빈 줄이 빠진 곳과 일반 텍스트를 감싼 코드 펜스가 없는지 결과를 훑어본 뒤, Markdown 렌더러로 미리 보세요.

제한과 경계

  • OCR 없음. 이미지만 있는 페이지는 거의 또는 전혀 추출되지 않음
  • 레이아웃 충실도는 제한적
  • 복잡한 표는 손으로 고쳐야 할 수 있음
  • 이미지뿐인 PDF는 오류가 아니라 성공한 0바이트 파일을 반환함
  • 테스트에서 고정폭 글꼴 텍스트는 코드 펜스 안에 담겨 돌아옴
  • 목록 뒤에 오는 제목 앞에 빈 줄이 빠질 수 있음
  • 이 사이트의 업로드 한도는 파일당 500MB이며, 약 95MB를 넘으면 나누어 전송합니다. API 직접 요청 한 건의 본문은 100MB까지입니다.

예시

  • 글로 된 백서는 문단과 제목이 있는 .md 파일이 됨
  • OCR하지 않은 스캔은 쓸 만한 Markdown이 거의 또는 전혀 나오지 않음
  • 제목 하나, 제목 둘, 글머리 목록, 세 행짜리 표가 있는 워드 프로세서 내보내기는 `# `, `## ` 제목, `- ` 글머리, 파이프 표를 만들어 냄
  • 그림 세 장으로 만든 PDF는 HTTP 200과 함께 빈 `.md`를 반환함
  • 고정폭 글꼴로 PDF로 바꾼 텍스트 파일은 약 210줄짜리 펜스 코드 블록 하나로 돌아옴

이 도구의 개인정보 안내

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

자주 묻는 질문

Markdown이 비어 있는 이유는요?
그 PDF에 텍스트 레이어가 없을 가능성이 큽니다. 스캔은 OCR → Markdown을 쓰세요. 이 도구는 파일에 이미 있는 텍스트만 읽습니다.
OCR과 같나요?
아닙니다. OCR은 이미지 페이지를 봅니다. PDF를 Markdown으로는 pdf-inspector로 네이티브 텍스트를 읽습니다.
글꼴이 유지되나요?
Markdown은 텍스트에 가벼운 구조를 더한 것입니다. 글꼴은 나중에 Markdown을 렌더하는 쪽에서 정해집니다.
Markdown을 다시 PDF로 만들 수 있나요?
가능합니다. Markdown을 PDF로를 쓰세요. 레이아웃은 원래 PDF와 맞지 않습니다.
표도 변환되나요?
단순한 표는 될 수 있습니다. 세 행짜리 테스트 표는 머리글 행이 있는 Markdown 파이프 표로 돌아왔습니다. 병합된 셀, 중첩된 표, 여러 페이지에 걸친 표는 손으로 고쳐야 할 수 있습니다. 표만 중요하다면 PDF를 CSV로가 더 나은 대상입니다.
문서 전체가 코드 블록 안에 들어 있는 이유는요?
고정폭 글꼴로 조판한 테스트 PDF는 펜스 코드 블록에 감싸여 돌아왔습니다. 추출기가 텍스트를 그렇게 취급한 것입니다. 텍스트가 실제로 산문이라면 펜스 줄을 지우세요.
요청은 성공했는데 .md 파일이 비어 있는 이유는요?
서버가 이미지뿐인 PDF에 빈 본문의 HTTP 200을 반환했습니다. 추출할 텍스트가 없었습니다. 스캔과 페이지 사진에는 OCR을 쓰세요.
암호화되었거나 손상된 PDF에서는 어떤 오류가 나나요?
암호화된 파일은 이유 `password_required`와 함께 400을 반환합니다. 페이지는 비밀번호를 묻고, API 호출자는 먼저 비밀번호 해제를 실행합니다. PDF가 아닌 파일은 `invalid_pdf`와 함께 400을 반환하며, 힌트는 PDF 복구를 권합니다.
Markdown과 일반 텍스트 중 무엇을 써야 하나요?
제목과 목록이 저장소나 프롬프트까지 살아남아야 하면 Markdown을 쓰세요. 마크업 없이 글만 원하면 PDF를 텍스트로를 쓰세요.

최종 업데이트:

코드에서 호출하기

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

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

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

AI 에이전트에서 사용하기

스킬

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

전체 에이전트 스킬

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