Docling: 공식 문서로 비교하기
PDF를 마크다운으로 바꾸고 변환 결과를 확인하는 Docling의 공식 문서 기반 안내예요.
마지막 업데이트
메뉴나 지원 기능이 달라졌다면 아래 자료 확인일과 현재 앱 버전을 함께 봐주세요.

PDF를 마크다운으로 바꾸는 도구를 고를 때, 파일이 만들어지는지만 보면 중요한 차이를 놓칠 수 있어요. 제목의 순서, 표의 행·열, 저장한 파일을 다시 확인하는 방법까지 정해 두면 비교가 구체적이 돼요. 여기서는 Docling과 MarkItDown의 공식 문서를 비교하고 같은 입력으로 검증할 절차를 제안해요. 두 도구를 직접 실행한 후기나 속도 측정 결과는 아니에요. D2, D7
이 글은 Docling v2.142.0 공식 릴리스를 다뤄요. 공식 릴리스 기록의 공개일은 2026-10-22(UTC)이고, 자료 확인일은 2026-10-22이에요.
비교 범위와 같은 입력
Docling은 문서 형식 분석과 생성형 AI 연동을 위한 도구로 소개돼요. MarkItDown도 LLM과 텍스트 분석 파이프라인에서 쓸 마크다운을 만드는 파이썬 유틸리티라고 설명해요. 따라서 단순히 한쪽을 AI 도구, 다른 쪽을 일반 텍스트 도구로 나누는 비교는 맞지 않아요. F1, F6 이 글의 질문은 논문 한 편을 읽을 수 있는 마크다운으로 준비할 때 무엇을 확인해야 하는가예요.
예시 입력은 사용법 글과 동일해요. 출력 이름도 같게 적되 두 도구의 작업 폴더는 분리해 기존 파일을 덮어쓰지 않도록 해 주세요. 아래 입력을 실행한 결과물은 이번 작성에서 확보하지 않았어요.
Source PDF: https://arxiv.org/pdf/2408.09869
Output file: report.md
Docling은 선택된 v2.142.0의 문서·릴리스 기록을 기준으로 하고, 비교 대상은 자료 확인 시점에 고정한 MarkItDown 저장소 문서를 기준으로 해요. MarkItDown의 특정 설치 버전으로 시험한 비교가 아니므로 직접 비교할 때는 실제 설치 버전과 옵션을 별도로 기록해야 해요. D1, D7
결과물과 호환성은 무엇을 볼까요
결과물 측면에서 Docling은 공통 DoclingDocument 표현과 마크다운, 손실 없는 JSON 등의 내보내기를 안내해요. PDF의 레이아웃, 읽기 순서, 표 구조와 수식 분석도 README에 명시돼 있어요. D2 이런 문서 객체를 후속 코드에서 다루려는 경우 검토할 기능이지만, 기능이 있다는 사실만으로 이번 PDF의 구조가 모두 보존된다고 판단할 수는 없어요.
MarkItDown은 마크다운에서 제목·목록·표·링크 같은 중요한 구조와 내용을 보존하는 데 초점을 둔다고 설명해요. 사람이 보기 위한 높은 재현도의 문서 변환이 최선의 사용처는 아닐 수 있다는 제한도 함께 안내해요. D7 따라서 MarkItDown을 표를 전혀 다루지 못하는 도구로 설명하거나, Docling이 언제나 더 좋은 표를 만든다고 말할 근거는 없어요. 두 출력에서 같은 표를 확인하는 절차가 필요해요.
호환성에서는 Docling이 Python 3.10 이상과 macOS·Linux·Windows, x86_64·arm64 지원을 안내해요. MarkItDown은 Python 3.10부터 3.14까지를 요구해요. F3, F5, F7 같은 Python 버전 하나를 골라도 모든 선택 모델과 추가 패키지의 설치 조건까지 같아지는 것은 아니니, 실제 구성에서 요구하는 의존성을 확인해 주세요.
실행 방법과 저장 파일의 역할
Docling의 공식 파이썬 예시는 DocumentConverter로 입력을 변환하고 result.document.export_to_markdown()으로 문자열을 얻어요. MarkItDown 예시는 MarkItDown 객체의 convert() 결과에서 markdown 속성을 읽어요. F4, D7 어느 쪽이든 문자열 출력과 파일 저장은 구분해야 해요. 사용법 글의 report.md 저장 부분은 표준 파이썬 파일 작성 코드를 덧붙인 예시예요.
CLI로 비교하고 싶다면 Docling의 현재 참조 문서는 docling convert 명령, 마크다운 출력 선택과 —output 디렉토리를 안내해요. MarkItDown README는 markitdown 입력파일 -o 출력파일 형태를 보여줘요. D5, D7 한쪽의 디렉토리 옵션을 다른 쪽의 파일명 옵션과 같은 것으로 취급하면 원하는 위치에서 결과를 찾기 어려워요. 각 도구별 폴더에 입력·출력·옵션 기록을 구분해 두는 이유예요.
예상 결과는 각 작업 폴더에 읽을 수 있는 report.md가 생기는 것이에요. 완료 조건은 파일 존재뿐 아니라 원본의 제목 순서와 대표 표의 행·열·수치·각주를 확인하는 것으로 잡아 보세요. 변환이 끝난 뒤 텍스트 편집기에서 두 파일을 다시 열고, 선택한 페이지와 표의 누락·합쳐짐·순서 변경을 같은 기준으로 기록하면 돼요. 이는 앞으로 실행할 비교 절차이며 관측 결과는 아니에요.
시간과 불편함은 아직 측정하지 않았어요
시간 항목은 두 도구 모두 미측정이에요. README의 lightweight라는 설명을 실행 시간이 더 짧다는 수치로 바꾸지는 않을게요. D7 직접 시간을 기록한다면 패키지 설치·모델 다운로드·문서 변환·사람의 수정 시간을 각각 구분해 주세요. 첫 실행에만 다운로드가 들어가는 구성과 준비된 환경의 재실행을 섞으면 어떤 차이를 잰 것인지 알기 어려워요.
불편함도 실제 사용 평가가 아니라 문서에서 확인한 설정 차이로 비교해요. Docling 설치 안내에는 PyTorch 배포판, CPU 전용 설치와 Intel Mac의 호환성 주의사항이 있어요. MarkItDown은 파일 형식별 선택 의존성과 기본 비활성 플러그인을 안내해요. D3, D7 자기 PDF에 필요한 기능이 무엇인지 확인하지 않고 모든 확장을 켜기보다, 기본 변환과 추가 기능의 필요성을 구분하는 편이 설정을 이해하기 좋아요.
결과 재확인에 쓸 Docling의 confidence 정보도 완성된 정확도 성적표는 아니에요. 공식 가이드는 mean_grade·low_grade를 참고하도록 안내하며 수치 계산법은 바뀔 수 있다고 설명해요. table_score는 아직 구현되지 않았다고 명시돼 있어요. F8, F9 개발자 화면 속 EXCELLENT 표시를 이번 입력의 품질 결과로 가져오면 안 돼요.
자동화와 이용 비용을 확인할 부분
자동화는 두 도구 모두 파이썬 코드나 CLI를 연결하는 문서가 있어요. Docling v2.142.0 릴리스에는 변환 실패 시 CLI가 종료 코드 1을 반환하는 수정이 기록돼 있어요. F2, D7 이는 실패한 작업을 후속 단계에서 구분하는 데 참고할 동작이지, 변환 내용까지 맞다는 검증은 아니에요. 파일 생성 여부와 내용 확인을 별도의 완료 조건으로 유지해 주세요.
Docling 코드의 MIT 라이선스와 개별 모델의 라이선스는 별도로 확인해야 해요. MarkItDown 문서는 기본 변환과 Azure Document Intelligence·Content Understanding 연동을 구분하고, Azure 연동에는 청구되는 API 호출이 있다고 안내해요. D2, D7 이번 비교는 유료 서비스의 현재 단가나 무료 제공량을 조사한 것이 아니므로 특정 가격을 제시하지 않아요. 실제 비교에서는 앱 코드 비용, 선택 모델·서비스 비용과 자기 장비의 연산 조건을 나눠 기록해 주세요.
대상 사용자와 비교를 마치는 기준
대상 사용자를 고를 때는 원하는 결과부터 정해 보세요. 문서 객체와 다양한 내보내기 형식을 후속 프로그램에서 다루려면 Docling의 문서 표현을 살펴볼 만해요. 이미 마크다운 입력을 받는 LLM 작업이 있고 파일 형식별 변환 경로를 확인하고 싶다면 MarkItDown의 문서가 출발점이 될 수 있어요. D2, D7 이는 기능과 작업을 연결한 편집자 판단이며 두 도구의 품질 순위를 매긴 결과는 아니에요.
같은 입력 비교를 완료하려면 PDF 원본, 설치 버전, 활성화한 옵션과 두 출력 파일이 함께 남아 있어야 해요. 제목과 대표 표에 누락이 없는지, 수정할 부분이 어디인지, 실패가 어떻게 표시됐는지까지 기록해 보세요. 결과물·시간·호환성·불편함·자동화·대상이라는 여섯 항목 중 관측하지 않은 값은 미측정으로 남기면 돼요. 어느 쪽이 더 빠르거나 정확하다는 결론은 이 절차를 실제로 수행한 뒤에 판단할 수 있어요.
BumbleV가 만든 자료 안내 그림이며 실제 앱 화면이나 실행 결과가 아니에요. 그림의 근거가 된 공식 발표 · CC BY 4.0 · 2026-10-22

참고 자료
- https://github.com/docling-project/docling/releases/tag/v2.142.0
- https://raw.githubusercontent.com/docling-project/docling/6aaf87ebd99b8c7d3699d90f7aba372555d0140e/README.md
- https://raw.githubusercontent.com/docling-project/docling/6aaf87ebd99b8c7d3699d90f7aba372555d0140e/docs/getting_started/installation.md
- https://raw.githubusercontent.com/docling-project/docling/6aaf87ebd99b8c7d3699d90f7aba372555d0140e/docs/getting_started/quickstart.md
- https://raw.githubusercontent.com/docling-project/docling/6aaf87ebd99b8c7d3699d90f7aba372555d0140e/docs/reference/cli.md
- https://raw.githubusercontent.com/docling-project/docling/6aaf87ebd99b8c7d3699d90f7aba372555d0140e/docs/concepts/confidence_scores.md
- https://raw.githubusercontent.com/microsoft/markitdown/21d9c1d01ecc12538dab19811fd247ef2f96ef60/README.md
- https://api.github.com/repos/docling-project/docling