MarkItDown으로 PDF·워드를 AI용 글로

MarkItDown · 파이썬 · 읽는 데 10분 · 2026-09-30 확인

AI는 PDF나 엑셀을 통째로 받는 것보다 깔끔한 글을 받을 때 더 정확하고 토큰(AI가 글을 세는 단위)도 덜 먹어요.

MarkItDown은 문서를 마크다운(# 제목, - 목록 같은 기호로 구조를 표시한 글)으로 바꿔 주는 도구예요. 표와 제목 구조를 살려 줘서 요약·검색 앞 단계로 딱이에요.

1단계설치하기

파이썬 3.10 이상이 필요해요. 맥 기본 파이썬은 3.9일 수 있으니 먼저 확인하세요.
```
python3 --version
```
모든 형식을 다루는 옵션까지 한 번에 깔아요.
```
pip install 'markitdown[all]'
```

2단계파일 하나 바꾸기

터미널에서 파일 이름만 주면 결과를 파일로 저장해요.
```
markitdown 보고서.pdf -o 보고서.md
```
엑셀도 똑같아요. 시트마다 표로 바뀌어요.
```
markitdown 매출.xlsx -o 매출.md
```

되는 형식: PDF, 파워포인트, 워드, 엑셀, 이미지, 오디오, HTML, CSV, JSON, XML, ZIP, EPUB, 유튜브 주소.

3단계폴더 통째로 바꾸기

문서 폴더 옆에 아래 파일을 convert_all.py로 저장해요. '문서' 폴더의 파일을 '마크다운' 폴더에 하나씩 바꿔 담아요.

from pathlib import Path
from markitdown import MarkItDown

md = MarkItDown(enable_plugins=False)
src = Path("문서")
out = Path("마크다운")
out.mkdir(exist_ok=True)

for f in sorted(src.iterdir()):
    if f.suffix.lower() not in {".pdf", ".docx", ".xlsx", ".pptx"}:
        continue
    result = md.convert(str(f))
    (out / (f.stem + ".md")).write_text(result.markdown, encoding="utf-8")
    print("완료:", f.name)

실행해요.
```
python3 convert_all.py
```

만든 .md 파일을 그대로 AI에 붙여 넣거나, '파이썬 30줄 회의록 요약 스크립트' 가이드의 입력으로 쓰면 돼요.

한국 직장인이 걸리는 곳

한글(HWP) 파일은 목록에 없어요 — 한글 프로그램에서 PDF나 DOCX로 저장한 뒤 바꾸세요.

스캔한 PDF — 글자가 그림으로 들어 있으면 거의 안 나와요. 결과가 비었으면 이 경우예요.

보기 좋은 변환이 목표가 아니에요 — 사람 눈보다 AI가 읽기 좋게 구조를 남기는 도구라, 서식은 많이 빠져요.

문서 스무 개를 복사·붙여넣기 하던 시간이 1분으로 줄어요. 남는 시간엔 그냥 쉬세요.

출처 (2026-09-30 확인)
GitHub microsoft/markitdown (MIT 라이선스) — https://github.com/microsoft/markitdown