GITHUB PROJECT REVIEW · 문서·코드 검토

PDF를 AI에 올리기 전,
Docling으로 구조를 살릴 수 있을까

PDF를 그냥 복사하면 표의 열과 문단 순서가 뒤섞일 수 있습니다. Docling은 문서를 먼저 구조화해 Markdown이나 JSON으로 내보내는 오픈소스입니다. 유용해 보이는 지점과 사람이 반드시 확인할 지점을 함께 읽었습니다.

RHX EDU 편집 · 2026.09.30 공식 저장소·문서 검토 · 자체 성능 측정 전

DOCS → STRUCTURE → AI문서를 그대로 넣기 전에
무엇이 빠졌는지 본다.

어떤 문제에 맞나

행사 운영계획 PDF에서 표의 담당자와 시각을 추출해 AI에게 요약을 맡긴다고 해보겠습니다. 복사한 텍스트에서 표 셀이 밀리면, AI는 틀린 담당자에게 조치를 배정할 수 있습니다. 문서를 읽기 쉬운 형식으로 바꾼 뒤 원본과 대조할 표를 남기는 과정이 필요합니다.

Docling 저장소는 PDF뿐 아니라 DOCX, PPTX, XLSX, HTML, 이미지와 음성 등 여러 형식을 파싱하고, PDF의 배치·읽기 순서·표 구조와 OCR을 지원한다고 설명합니다. 결과를 Markdown·HTML·JSON 등으로 내보낼 수 있습니다.

실무에 넣는다면 이 순서

  1. 공개 또는 가상 문서로 시작 — 원본 PDF를 보관하고 페이지 수·표 수·핵심 숫자 세 개를 적습니다.
  2. Markdown으로 변환 — 표 제목과 행·열, 두 단짜리 문단의 읽는 순서가 살아 있는지 봅니다.
  3. 원본과 대조 — AI 요약 전에 담당자·날짜·금액·각주·이미지 안 글자를 확인합니다.
  4. AI에 전달 — 확인된 Markdown과 원본 페이지를 함께 두고, 불확실한 셀은 빈칸 또는 확인 필요로 남깁니다.
핵심 판단 변환 성공 메시지는 내용 검수 완료를 뜻하지 않습니다. 스캔 품질, 표 병합 셀, 각주와 도장은 별도로 확인합니다.

직접 시험할 최소 예제

공식 README의 설치·CLI 예시는 아래와 같습니다. 로컬 설치가 가능한 개인 PC에서 공개 PDF 한 장으로 먼저 시험하세요. 이 글은 코드를 검토한 것이며, 한국어 공문서의 정확도는 직접 측정하지 않았습니다.

python -m pip install docling
docling 공개문서.pdf

저장소는 Python 3.10 이상과 macOS·Linux·Windows 환경을 안내합니다. 다른 OCR 엔진, 표 모드, 페이지 범위는 공식 CLI 문서에서 조정할 수 있습니다.

기준 문서표 1개, 두 단 문단 1개, 날짜·금액·담당자 각 1개가 있는 공개 PDF
합격 기준원본과 Markdown에서 표 셀·읽는 순서·세 고유값이 모두 일치
실패 기록틀린 셀과 원본 페이지 번호, OCR 사용 여부를 함께 남김
다음 단계그때만 AI 요약에 투입하고 요약 결과의 숫자를 다시 확인

도입 전 경계

로컬 실행 기능은 민감한 문서를 다룰 때 검토할 만하지만, 어떤 모델과 옵션을 켜는지에 따라 다운로드나 외부 서비스 사용 여부가 달라질 수 있습니다. 공식 문서는 원격 서비스 사용을 별도 옵션으로 제어한다고 설명합니다. 실제 조직 문서에 쓰려면 설치 패키지와 모델 파일, 저장 위치, 로그, 접근 권한을 조직 기준에 맞춰 확인해야 합니다.

저장소 코드는 MIT 라이선스지만 개별 모델 라이선스는 따로 확인해야 합니다. 이번 글에는 실제 공문서 변환 성능이나 처리 속도 비교를 싣지 않았습니다. 그 수치를 보여주려면 공개 문서로 재현 가능한 테스트가 먼저 필요합니다.