모든 글

MarkItDown: 공식 문서로 비교하기

MarkItDown과 Docling의 PDF·Markdown 변환, 설치 조건, 자동화와 문서 구조 처리 범위를 공식 문서로 비교해요. 같은 파일로 표·숫자·누락을 점검할 기준도 살펴봐요.

마지막 업데이트

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

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

PDF를 LLM에 넣을 텍스트로 바꾸려면 MarkItDown과 Docling 중 무엇부터 확인하면 좋을까요? 두 도구의 공식 문서를 기준으로 작업 흐름과 확인할 항목을 비교해 볼게요. 직접 실행한 후기나 속도 측정은 아니에요. 예제 입력과 비교 절차는 독자가 같은 조건으로 확인할 수 있도록 제안하는 것이며, 아래에 두 도구의 실제 변환 결과를 제시하지는 않아요.

이 글은 MarkItDown v0.1.9 공식 릴리스를 다뤄요. 공식 릴리스 기록의 공개일은 2026-10-21(UTC)이고, 자료 확인일은 2026-10-24이에요.

두 도구가 하려는 일부터 구분해요

MarkItDown은 여러 형식의 파일을 Markdown으로 바꿔 LLM이나 텍스트 분석 파이프라인에 사용하도록 만든 Python 유틸리티예요. 제목·목록·표·링크처럼 중요한 구조를 표현하는 데 초점을 두지만, 사람이 보는 원본 문서의 모양을 높은 충실도로 재현하는 목적에는 적합하지 않을 수 있다고 README에서 설명해요. 따라서 “복잡한 문서를 넣으면 서식까지 완벽하게 보존된다”는 기대는 내려놓는 편이 좋아요. F1, D2

Docling의 README는 다양한 형식의 파싱, 고급 PDF 이해와 생성형 AI 생태계 통합을 강조해요. CLI 변환 외에 Python의 DocumentConverter를 사용하고 변환된 문서를 Markdown으로 내보내는 예시도 제공해요. 이것은 공개된 기능 범위의 차이예요. 같은 PDF의 표를 어느 쪽이 더 정확하게 읽는지, 어느 쪽이 더 빠른지까지 문서만으로 결정할 수는 없어요. F6, D3

같은 입력을 준비할 때의 기준이에요

예시 입력은 본인이 사용할 권한이 있는 로컬 PDF 한 개예요. 원본 이름을 source.pdf로 두고, 제목 하나와 목록 하나, 작은 표 하나가 있는 문서를 고르면 검사할 지점을 정하기 쉬워요. 실제 비교에서는 두 도구에 바이트가 같은 파일을 넣고, 설치 버전과 사용 옵션도 적어 주세요. 이것은 재현을 위한 제안이지 이 글에서 수행한 테스트 조건은 아니에요.

먼저 원본에서 기준을 정해 두면 결과가 그럴듯해 보이는 것만으로 성공했다고 판단하는 일을 줄일 수 있어요. 예를 들어 표의 열 이름과 행 수, 숫자의 소수점, 본문 문장 순서, 반복되는 머리글을 검사 목록으로 적어 보세요. 이미지 속 글자와 선택 가능한 본문 텍스트도 구별해 두면 좋아요. 이 목록은 독자가 확인할 항목이며, 모든 입력에서 그 항목을 정확히 변환한다는 기능 보장은 아니에요.

결과물·시간·호환성은 이렇게 비교해요

항목 MarkItDown 공식 문서에서 확인한 범위 Docling 공식 문서에서 확인한 범위 같은 입력으로 더 확인할 일
결과물 Markdown 변환과 CLI 출력 파일 지정 CLI의 .md 생성 및 Python의 Markdown 내보내기 제목·목록·표·숫자 누락을 원본과 대조
시간 이 글에서 측정하지 않음 이 글에서 측정하지 않음 설치·초기 준비와 변환 시간을 구분해 기록
호환성 Python 3.10~3.14 요구 Python 3.10 이상, macOS·Linux·Windows와 x86_64·arm64 안내 실제 운영체제와 필요한 의존성 설치 확인
불편함 형식별 선택 의존성과 입력 권한 관리 필요 설치 구성과 모델별 이용 조건 확인 필요 실패 메시지와 수동 수정 지점을 기록
자동화 CLI와 Python에서 변환 호출 CLI 및 DocumentConverter 예제 제공 파일 경로·출력 이름·오류 처리 방식을 정함
대상 사용자 Markdown을 텍스트 분석에 연결하려는 사람 문서 처리와 AI 통합 기능을 함께 검토하는 사람 자신의 후속 작업이 결과를 읽는지 확인

표의 기능 범위는 두 README에서 확인한 내용이고, 대상 사용자는 그 범위에 따른 편집상 제안이에요. 표에는 실제 속도나 정확도 점수를 넣지 않았어요. MarkItDown의 Python 지원 범위를 Docling의 운영체제 지원 문장과 섞어서 모든 환경에서 동일하게 작동한다고 단정하지도 않아요. F3, F8, D2, D3

명령어와 저장 파일의 역할을 확인해요

MarkItDown의 공식 CLI 예시는 다음과 같아요. source.pdf는 본인의 입력 경로로 바꾸고, document.md는 새 출력 이름으로 정해 주세요. 입력 파일과 출력 파일은 역할이 다르므로 원본 PDF를 별도로 보관하고, 중요한 기존 출력이 있다면 겹치지 않는 이름을 쓰는 편이 좋아요. 실제 실행 결과를 제공하는 명령 블록은 아니에요. F7

예시 입력:

markitdown source.pdf -o document.md

Docling은 README에서 다음 CLI 예시를 제공해요. 원문 예시 자체는 공개 PDF URL을 입력으로 사용하며, 현재 디렉터리에 구조화된 문서 내용을 담은 .md 파일을 만든다고 설명해요. 이 URL 예제와 위의 로컬 파일 예제를 실행해 시간을 재면 입력 조건이 다르므로 공정한 성능 비교가 아니에요. 실제 비교에서는 앞서 준비한 동일 로컬 파일을 사용하고 두 도구의 출력 파일이 섞이지 않도록 작업 폴더를 나눠 주세요. D3

공식 문서 예시:

docling https://arxiv.org/pdf/2206.01062

예상 결과는 Markdown 파일을 얻는 것이지만, 문서별로 어떤 문장이나 표가 출력될지는 직접 확인해야 해요. 변환 후에는 파일을 텍스트 편집기와 Markdown 뷰어로 다시 열어 보세요. 텍스트가 존재하는지 확인하는 단계와 표·문장 순서가 맞는지 확인하는 단계는 별개예요. 원본과 중요한 부분을 대조하지 않았다면 결과물 비교를 완료로 표시하지 않는 편이 좋아요.

이용 조건과 오류를 비교할 때 주의해요

MarkItDown은 실행 중인 프로세스가 접근할 수 있는 자원에 같은 권한으로 접근해요. 따라서 모르는 입력을 그대로 넘기지 말고, 필요한 변환 범위를 좁히라는 공식 보안 안내를 따라 주세요. 플러그인은 기본적으로 꺼져 있고 필요한 경우 활성화하는 방식이에요. 입력 권한 오류와 필요한 패키지가 없는 오류를 같은 문제로 취급하지 말고 파일 경로·권한·선택 의존성을 각각 점검해 주세요. F5, D2

비용도 구분해야 해요. 기본 로컬 변환의 계산 자원과, 선택한 외부 AI·Azure 서비스의 API 이용료는 같은 비용이 아니에요. MarkItDown README의 클라우드 기능을 켜면 해당 서비스의 과금 조건을 확인해야 해요. Docling은 코드의 MIT 라이선스와 개별 모델의 이용 조건을 구분해 안내해요. 오픈소스라는 이유만으로 연결한 모든 모델과 외부 서비스가 같은 조건이라고 가정하지 마세요. D2, D3

어느 쪽을 고를지 판단하는 완료 조건이에요

짧은 변환 스크립트에 Markdown 출력을 붙이는 흐름을 먼저 살펴보려면 MarkItDown의 CLI·Python 예제가 출발점이 될 수 있어요. PDF 이해와 후속 AI 통합까지 함께 검토하려면 Docling이 공개한 문서 모델과 통합 예제도 살펴보세요. 이는 문서에 나온 기능을 바탕으로 한 선택 안내이며 우열 판정이나 사용 후기는 아니에요. F1, F6

비교 완료 조건은 같은 파일을 변환한 두 결과를 다시 열고, 미리 정한 원문 검사 항목을 모두 대조하는 것이에요. 누락이나 수동 수정이 필요하면 그 위치와 이유를 남기고, 실행하지 못한 환경은 접근 실패로 기록해 주세요. 시간은 실제로 측정한 값만 쓰고, 설치에 쓴 시간과 변환에 쓴 시간은 나눠 적어 주세요. 이 글에서는 그 실행을 하지 않았으므로 결과물·시간·정확도에 대한 승자를 정하지 않아요.

공통 예시 입력이에요. 독자가 준비할 입력 조건이며 직접 실행한 기록이 아니에요.

Input file: source.pdf (a local PDF you have permission to process)
Check one heading, one list and one table against the original.

MarkItDown documentation reading guide

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

소개

한 가지 작업 따라 하기

공식 문서로 비교하기

MarkItDown AI 제작 개념 설명 그림 — 실제 화면 아님
BumbleV가 AI로 만든 개념 설명 그림이에요. 실제 앱 화면이나 실행 결과가 아니에요. 재사용 조건이 확인된 실제 화면을 확보하지 못해 이 그림을 사용했어요. 사용법은 공식 문서를 바탕으로 설명하며 결과는 직접 확인해야 해요. 설명의 근거가 된 공식 발표 · 21d9c1d01ecc · CC BY 4.0 · 2026-10-24 ·

참고 자료