본문으로 건너뛰기
PPDF123

PDF의 표를 CSV로 내보내기

PDF를 CSV로는 PDF의 글에서 열이 맞춰진 표 행을 찾아 감지한 표마다 CSV 파일로 씁니다. 표가 여러 개면 ZIP으로 돌아옵니다. 텍스트 층이 필요하며 산문이나 스캔에는 아무것도 돌려주지 않습니다.

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

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

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

PDF를 CSV로는 `pdftotext -layout`을 실행해 연속 공백이 둘 이상인 줄을 찾고 그 줄을 CSV로 씁니다. 감지된 표마다 `{base}_pN_tM.csv` 이름의 파일이 됩니다. 뽑힌 글에서 열이 이미 맞춰진 전자 PDF에 맞습니다.

표로 인정하려면 표처럼 보이는 연속 두 줄 이상이 필요합니다. 산문, 한 줄짜리 머리글, 텍스트 층이 없는 스캔은 `no_content`(HTTP 204, 파일 없음)입니다. 이 빈 결과는 의도된 동작이며 조용한 실패가 아닙니다.

표 하나는 `text/csv` 다운로드 하나가 됩니다. 표가 여러 개면 `{base}_extracted.zip` 이름의 ZIP이 됩니다. 이 페이지의 `pageNumbers` 필드는 무시되며 모든 페이지를 스캔합니다.

OCR이 아닙니다. 이미지만 있는 스캔에는 `pdftotext`가 읽을 내용이 없습니다. 이 사이트 OCR은 Markdown을 반환하며 PDF를 CSV로에 다시 넣을 수 없습니다. 열은 연속 공백 둘 이상으로 자르며, 셀 안의 단일 공백은 셀에 남습니다. 값은 RFC 4180으로 따옴표 처리합니다.

PDF를 Excel로는 같은 판면 휴리스틱을 씁니다. Excel은 그 표들을 한 통합 문서의 각 시트에 둡니다. CSV는 표마다 파일 하나입니다. 둘 다 PDF에서 병합 셀·색 머리글·숨은 시트를 복원하지 않습니다.

스프레드시트로 다운로드를 열어 몇 행의 열 분할을 점검하세요. 이중 공백 간격이 없는 촘촘한 표는 한 열로 떨어지는 경우가 많습니다. 비밀번호로 보호된 파일은 이 페이지에서 비밀번호를 입력하면 자동으로 해제됩니다. API 호출자는 먼저 비밀번호 해제를 실행하세요.

핵심은 이중 공백 휴리스틱 자체입니다. 변환기는 사람처럼 셀 경계를 인식하지 않고, 판면이 보존된 글에서 연속 공백 둘 이상을 열 구분으로 봅니다. 셀을 고정 폭으로 채우는 보고서 생성기가 만든 표에는 잘 맞지만, 열 사이가 공백 하나뿐이거나 비례 글꼴로 열이 거의 붙어 있는 표에는 실패합니다.

숫자·날짜·식별자는 형이 있는 스프레드시트 값이 아니라 텍스트로 기록됩니다. 숫자 열도 CSV에서는 숫자를 품은 문자열일 뿐이라 앞의 0이 살아남고, 날짜는 PDF가 쓰던 형식을 그대로 유지합니다. 가져온 뒤 계산이나 날짜 정렬이 필요하면 스프레드시트에서 올바른 형으로 변환하세요.

아주 넓거나 아주 긴 표는 PDF 페이지를 넘어 끊길 수 있고, 각 페이지는 따로 스캔됩니다. 2페이지로 이어지는 표는 두 번째 `{base}_pN_tM.csv` 파일이 됩니다. 조각은 모두 받지만 이어 붙이는 일은 직접 해야 합니다. 이 도구는 페이지 나눔을 넘어 표를 꿰매지 않습니다.

구분자는 쉼표로 고정되고 인용은 RFC 4180을 따르므로, 쉼표가 든 셀은 따옴표로 감쌉니다. 세미콜론이나 탭을 내보내는 옵션은 없습니다. 스프레드시트 로케일이 세미콜론을 기대한다면 파일을 두 번 클릭하지 말고 구분자를 쉼표로 명시해 가져오세요.

CSV가 비었을 때 가장 먼저 할 일은 PDF 글을 실제로 선택할 수 있는지 확인하는 것입니다. 파일을 열어 한 행을 강조해 보세요. 아무것도 선택되지 않으면 스캔 파일이라 CSV는 절대 나오지 않습니다. OCR을 Markdown으로 하면 열은 아니어도 최소한 글자는 얻을 수 있습니다.

기능

  • `pdftotext -layout`과 이중 공백 열 분할 휴리스틱
  • 표마다 CSV 하나, 여러 개면 ZIP
  • 감지 결과가 비면 HTTP 204, OCR 아님
  • 값은 RFC 4180 텍스트, 형 추론도 구분자 선택도 없음
  • 익명 API: /api/v1/convert/pdf/csv

이런 경우에

  • 전자 송장 표를 스프레드시트로 가져옴
  • 여러 페이지의 표를 각각 별도 CSV 파일로 둠
  • 판면이 맞춰진 PDF 표를 CSV를 기대하는 스크립트에 넣음
  • 고정 폭 재무 보고서에서 가격표를 뽑아냄

PDF 표를 CSV로 추출하려면?

  1. 선택 가능한 글이 있고 표처럼 열이 나뉜 PDF를 업로드합니다.
  2. 처리를 누릅니다. 페이지 범위 필드는 변환기가 읽지 않습니다.
  3. 표 하나면 `.csv`, 여러 개면 ZIP을 내려받습니다. 없으면 빈 성공입니다.
  4. CSV를 열어 분할을 확인합니다. 순수 산문 PDF는 파일이 생기지 않습니다.

제한과 경계

  • 선택 가능한 글과 이중 공백 열 간격이 필요
  • OCR 없음, 페이지 범위 조작도 적용되지 않음
  • 병합 셀과 스타일을 복원하지 않음
  • 모든 값이 형 없는 텍스트, 구분자 선택도 없음
  • 페이지를 넘는 표는 별개 조각으로 도착
  • 이 사이트의 업로드 한도는 파일당 500MB이며, 약 95MB를 넘으면 나누어 전송합니다. API 직접 요청 한 건의 본문은 100MB까지입니다.

예시

  • 세 열 가격표가 있는 글 PDF는 종종 그 열의 CSV 하나가 됨
  • 텍스트 층이 없는 스캔 은행 거래명세서는 HTTP 204
  • 페이지마다 표가 하나씩 있는 다섯 페이지 보고서는 CSV 다섯 개의 ZIP이 됨

이 도구의 개인정보 안내

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

자주 묻는 질문

CSV가 없는 이유는요?
연속 두 줄 이상의 표 행을 찾지 못했습니다. 스캔, 산문, 이중 공백 간격이 없는 표는 이 휴리스틱이 실패합니다. API는 204 `no_content`로 응답합니다.
먼저 OCR한 뒤 CSV로 바꿀 수 있나요?
아니요. OCR은 Markdown을 반환합니다. 이 도구는 pdftotext로만 PDF를 읽습니다.
PDF를 Excel로와 무엇이 다른가요?
감지는 같습니다. CSV는 표마다 파일 하나(하나면 CSV, 여러 개면 ZIP)입니다. Excel은 각 표를 한 통합 문서의 각 시트에 씁니다.
이 양식의 페이지 목록이 무슨 일을 하나요?
아무 일도 하지 않습니다. pdftotext는 페이지 나누기 문자로 페이지를 나누고 모든 페이지를 스캔합니다. 페이지 범위 매개변수는 없습니다.
왜 모든 열이 한 셀에 들어갔나요?
PDF가 열 사이에 단일 공백만 두어 이중 공백 규칙이 발동하지 않았습니다. 고정 폭 열로 원본을 다시 내보내거나, OCR을 Markdown으로 한 뒤 직접 나누세요.
숫자가 숫자로 가져와지나요?
아니요. 모든 값이 일반 텍스트입니다. 앞의 0은 살아남고 날짜는 PDF 형식을 유지합니다. 정렬이나 계산이 필요하면 가져온 뒤 스프레드시트에서 형을 변환하세요.
두 페이지에 걸친 표는 어떻게 되나요?
각 페이지를 따로 스캔하므로 긴 표는 여러 CSV 조각이 됩니다. 이어 붙이는 일은 직접 하세요. 이 도구는 페이지 나눔을 넘어 표를 합치지 않습니다.

최종 업데이트:

코드에서 호출하기

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

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

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

AI 에이전트에서 사용하기

스킬

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

전체 에이전트 스킬

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