모든 글

Docling: 소개

PDF를 마크다운으로 바꾸고 변환 결과를 확인하는 Docling의 공식 문서 기반 안내예요.

마지막 업데이트

메뉴나 지원 기능이 달라졌다면 아래 자료 확인일과 현재 앱 버전을 함께 봐주세요.

앱 · APP
공식 자료를 읽고 정리했어요 · 직접 실행한 후기는 아직 없어요 자료 확인일:

논문 PDF를 AI 앱에 넣기 전에 제목과 표를 읽을 수 있는 텍스트로 정리하고 싶을 때가 있어요. Docling은 문서를 분석해 마크다운이나 구조화된 데이터로 바꾸는 파이썬 도구예요. 이번 글은 직접 실행한 후기가 아니라 공식 문서 기반 소개예요. 어떤 자료를 준비하는 데 쓰는지와 적용 전에 확인할 점을 함께 살펴볼게요. F1, D2

이 글은 Docling v2.142.0 공식 릴리스를 다뤄요. 공식 릴리스 기록의 공개일은 2026-10-22(UTC)이고, 자료 확인일은 2026-10-22이에요.

어떤 작업을 위한 툴인가

Docling은 다양한 문서 포맷을 분석하고 생성형 AI 에코시스템과 매끄럽게 연동할 수 있도록 돕는 문서 처리 도구예요 F1. 특히 고급 PDF 이해 기능을 제공하여 페이지 레이아웃, 읽기 순서, 표 구조, 코드, 수식 등을 분석하는 기능을 안내해요 D2. 개발자와 연구원들이 논문이나 보고서 같은 복잡한 문서를 마크다운이나 구조화된 데이터로 변환할 때 매우 유용하게 쓸 수 있어요.

이 도구는 PDF 외에도 DOCX, PPTX, XLSX, HTML, EPUB, 이미지, 오디오 및 비디오 파일까지 폭넓은 형식을 지원해요 D2. 공식 README는 로컬 실행과 인터넷이 분리된 환경에서의 활용 가능성을 안내해요. 다만 실제 사용 모델, 자료 다운로드와 외부 서비스 설정까지 확인해야 자기 환경의 데이터 흐름을 판단할 수 있어요. 로컬 실행 기능을 모든 설정의 보안 보장으로 읽지는 마세요. D2, D3 LangChain이나 LlamaIndex 같은 인기 프레임워크와도 쉽게 연동되므로 에이전트 기반 AI 앱을 개발할 때 연동 후보로 살펴볼 수 있어요 D2.

기존 툴과의 차이

문서를 마크다운으로 변환해 주는 가벼운 파이썬 유틸리티인 MarkItDown과 비교해 보면 Docling의 특징이 더 잘 드러나요 F6. 두 도구 모두 LLM 파이프라인에 필요한 텍스트를 준비하는 목적을 가지지만, Docling README는 표 구조, 수식과 레이아웃 분석을 기능으로 명시해요. 이 기능 목록만으로 다른 도구보다 변환 품질이 좋다고 판단할 수는 없어요. D2 반면 MarkItDown은 다양한 포맷을 가볍게 변환하는 데 초점을 맞춘 범용 유틸리티로 소개돼요. F6

Docling은 DoclingDocument라는 공통 문서 표현과 마크다운, 손실 없는 JSON 등의 내보내기 형식을 안내해요. MarkItDown은 마크다운을 중심으로 문서를 준비하는 도구라고 설명해요. D2, D7 편집자 관점에서는 텍스트만 필요한지, 구조화된 문서 객체도 필요한지를 먼저 정하면 비교하기 쉬워요. 실제로 어느 쪽이 표를 더 잘 보존하는지와 수정 시간이 얼마나 드는지는 같은 PDF를 변환해 대조해야 해요. 이번 소개에서는 그 실험을 수행하지 않았어요.

공개 상태·비용·이용 조건

Docling은 오픈소스 프로젝트로 제공되며, 코드는 MIT 라이선스를 따르고 있어요 D2. 기본 소스코드와 핵심 패키지는 자유롭게 이용할 수 있지만, 개별 AI 모델이나 특정 확장 기능을 사용할 때는 각 모델의 원본 라이선스를 확인해야 해요 D2. MIT 코드 라이선스와 개별 모델의 이용 조건은 구분해서 확인해 주세요. D2 여기서 특정 호스팅 서비스의 무료 제공량이나 유료 모델 단가를 확인한 것은 아니에요. 가격이 필요한 구성은 해당 서비스의 이용 조건을 별도로 확인해야 해요.

설치와 사용은 파이썬 패키지 관리자를 통해 진행할 수 있어요 F3. 파이썬 3.10 버전 이상 환경이 필요하며, 2.70.0 버전부터는 파이썬 3.9 지원이 중단되었으니 주의해 주세요 F5. 맥OS, 리눅스, 윈도우 환경과 x86_64 및 arm64 아키텍처를 모두 지원하므로 해당 플랫폼을 설치 후보로 살펴볼 수 있어요 F3.

확인된 기능과 미확인 사항

공식 문서와 릴리스 노트를 통해 확인된 주요 기능으로는 다양한 문서 포맷 파싱, CLI 및 파이썬 API를 통한 간편한 변환, 신뢰도 점수(Confidence Report)를 통한 변환 품질 평가 등이 있어요 F2, F4, D6. 특히 v2.142.0 릴리스에서는 문서 변환 실패 시 종료 코드를 1로 반환하도록 CLI 동작이 개선되는 등의 업데이트가 이루어졌어요 F2.

반면 공식 문서의 신뢰도 가이드에 따르면 표 추출 품질을 측정하는 table_score 등 일부 세부 지표는 아직 구현되지 않은 상태로 남아 있어요 F9. 또한 모든 복잡한 화학 분자 구조 이해나 고급 메타데이터 자동 추출 같은 일부 기능은 개발 예정(Coming soon) 상태로 안내되어 있으니 실제 프로젝트 적용 전에 지원 여부를 꼭 확인해 주세요 F5.

문서 변환 실습 가이드

파이썬 환경에서 Docling을 이용해 문서를 마크다운으로 변환하는 방법을 살펴볼게요. 이 내용은 공식 문서의 예시를 바탕으로 한 문서 기반 가이드이며, 이 글의 작성 과정에서 해당 변환을 직접 실행하지는 않았어요 F4.

  • 예시 입력:
from docling.document_converter import DocumentConverter

source = "https://arxiv.org/pdf/2408.09869"
converter = DocumentConverter()
result = converter.convert(source)
print(result.document.export_to_markdown())
  • 예상 결과: 공식 예시는 원본 문서를 변환한 마크다운 문자열을 출력하는 흐름을 보여줘요. README의 Docling Technical Report[...] 표기는 예시이며 실제 출력 전문이나 제목 기호가 항상 같다는 보장은 아니에요. F4

  • 완료 조건: 공식 예시의 변환 호출과 문자열 출력을 마친 뒤, 원본 PDF의 제목·본문·대표 표가 출력에 포함되는지 직접 대조해 보세요. F4 오류 없이 끝났다는 사실만으로 내용까지 정확하다고 판단하지 않는 것이 확인 기준이에요.

결과 비교 및 트러블슈팅

변환된 결과물을 원본 PDF와 비교할 때는 제목의 계층 구조와 표의 정렬 상태가 잘 유지되었는지 중점적으로 살펴보세요. 별도로 CLI를 이용한다면 --output은 결과 디렉토리를 지정하는 옵션이에요. 위 파이썬 print 예시가 자동으로 파일을 저장하는 것은 아니므로 두 방식을 혼동하지 마세요. F4, F10

문제가 발생했을 때는 파이썬 버전이 3.10 이상인지 확인하고 F5, PyTorch 의존성이나 운영체제별 아키텍처 차이로 인한 설치 오류가 있다면 공식 문서의 대체 PyTorch 배포판 안내를 참고해 주세요 F3. 변환 실패 시 에러 코드를 반환하는 이 릴리스의 CLI 동작을 활용하면 자동화 파이프라인에서 오류를 빠르게 감지하고 대처할 수 있어요 F2.

Docling documentation reading guide

BumbleV가 만든 자료 안내 그림이며 실제 앱 화면이나 실행 결과가 아니에요. 그림의 근거가 된 공식 발표 · CC BY 4.0 · 2026-10-22

소개

한 가지 작업 따라 하기

공식 문서로 비교하기

Docling developer interface example
개발자 저장소에 공개된 실제 화면 예시예요. 본문의 작업을 직접 실행한 결과는 아니며 현재 버전과 화면이 다를 수 있어요. 원본·출처 및 재사용 조건 · 6aaf87ebd99b · MIT · 2026-10-22 · Copyright The Docling Contributors The above copyright notice and this permission notice shall be included in all AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER

참고 자료