한 줄로 말하면
워드·엑셀·PPT만 바꾼다면 마이크로소프트의 MarkItDown으로 충분합니다. 한글(HWP·HWPX) 파일이나 한국 공문서 PDF가 섞여 있다면 kordoc이 훨씬 정확했습니다. 두 도구 모두 무료이고 내 컴퓨터 안에서 변환하므로 문서가 밖으로 나가지 않습니다.
두 도구는 파일을 올리는 웹 서비스가 아니라 내 컴퓨터에 설치해 쓰는 프로그램입니다. 명령어를 몰라도 Claude Code에 맡기면 설치부터 변환까지 대신 해 줍니다.
이런 분께
- 회사 문서나 공고문을 Claude 같은 AI에게 읽혀 요약·분석하려는 분
- 한글 파일을 AI가 읽지 못해 매번 복사해 붙여 넣고 있는 분
- 자료를 md 파일로 모아 AI 작업 폴더나 스킬 자료로 쓰려는 분
왜 md 파일로 바꾸나
md(마크다운)는 제목·목록·표를 기호 몇 개로 표시하는 글 파일입니다. 한글이나 PDF를 그대로 주면 AI가 표와 단락을 섞어 읽기 쉽지만, md로 바꿔 주면 어디가 제목이고 어디가 표인지 구조가 그대로 전달됩니다. 파일 크기도 작아서 같은 한도 안에서 더 많은 자료를 읽힐 수 있습니다.
도구 두 가지
| MarkItDown | kordoc | |
|---|---|---|
| 만든 곳 | 마이크로소프트(공개 프로젝트) | 국내 개발자 공개 프로젝트 |
| 비용·사용 조건 | 무료, MIT 라이선스(상업적 이용 가능) | 무료, MIT 라이선스(상업적 이용 가능) |
| 바꿀 수 있는 문서 | 워드·엑셀·PPT·PDF·이미지·음성·HTML 등 | 한글(HWP·HWPX)·PDF·워드·엑셀·PPT·이미지 |
| 한글 파일 | 지원하지 않음 | 지원 |
| 스캔·이미지 PDF | 글자를 읽지 못함 | 글자 인식(OCR) 옵션 있음 |
| 설치에 필요한 것 | 파이썬 3.10 이상 | Node.js 20 이상 |
| 공식 주소 | github.com/microsoft/markitdown | pubax.org/kordoc · GitHub |


직접 바꿔 본 결과
뉴런이 실제 문서 7개를 두 도구로 바꿔 봤습니다(2026년 11월 17일, MarkItDown 0.1.9·kordoc 4.24.82 기준).
| 문서 | MarkItDown | kordoc |
|---|---|---|
| 워드(표가 있는 강의 자료) | 제목·목록·표 모두 유지 | 제목·목록·표 모두 유지 |
| 엑셀(자가진단표) | 표로 바뀌지만 빈 칸에 "NaN", "Unnamed" 같은 글자가 섞임 | 합친 칸까지 살린 표로 바뀜 |
| PPT(강의 슬라이드) | 슬라이드별로 글자가 나옴 | 글자가 나옴 |
| PDF(정부 공고문, 글자 있음) | 문장이 표 칸으로 잘게 쪼개져 읽기 어려움 | 제목·목록·표 구조가 살아 있음 |
| PDF(이미지로만 된 자료) | 빈 결과 | 글자 인식 옵션으로 문단까지 읽음 |
| 한글(HWP 강의계획서 양식) | 변환 실패 | 칸을 합친 표까지 그대로 |
| 한글(HWPX 운영 안내) | 변환 실패 | 제목·항목이 정리돼 나옴 |
가장 큰 차이는 한국 공문서 PDF였습니다. MarkItDown은 공고문 한 줄을 여러 칸짜리 표로 잘라 놓아 AI가 읽어도 뜻이 이어지지 않았습니다. kordoc은 같은 파일에서 '사업목적', '지원대상' 같은 항목을 제목과 목록으로 정리해 냈습니다.
같은 공고문, 두 도구의 결과
중소벤처기업부의 「2026년도 예비창업패키지 예비창업자 모집공고(수정)」 PDF 첫 쪽을 바꾼 결과 중 같은 부분입니다.
MarkItDown — 한 문장이 여러 칸으로 흩어집니다.
| □ 사업목적 | | : | 혁신적인 | | 기술과 | 사업모델(BM)을 | | | 보유한 | 예비창업자의 | |
| | | | 성공 | 창업을 | 지원하여 | | 양질의 | 일자리 | 창출 | | |
□ 지원대상 : 예비창업자
※ 「중소기업창업 지원법」 제2조제4호·제9호에 따른 기술창업을 영위하고자 하는 자
□ 협약기간 : 협약
| | | | | 시작일로부터 | | 8개월 | | 이내(’26년6월~’27년1월 | | | 예정) |
| --- | --- | --- | --- | ------ | --- | --- | --- | ---------------- | --- | --- | --- |
kordoc — 항목이 한 줄씩, 제목과 목록으로 정리됩니다.
### □ 사업목적 : 혁신적인 기술과 사업모델(BM)을 보유한 예비창업자의 성공 창업을 지원하여 양질의 일자리 창출
## □ 지원대상 : 예비창업자
- ※ 「중소기업창업 지원법」 제2조제4호·제9호에 따른 기술창업을 영위하고자 하는 자
- ※ 신청자격은 본 공고 「3. 신청자격 및 요건」 참조
#### □ 협약기간 : 협약 시작일로부터 8개월 이내 (’26년 6월 ~ ’27년 1월 예정)
#### □ 선정규모 : 총 300명 내외 (일반분야 110명, 특화분야 190명 내외)
한글(HWP) 강의계획서 양식은 kordoc이 칸을 합친 표까지 그대로 옮겼습니다. 칸이 복잡한 표는 이렇게 HTML 표 형식으로 나오는데, AI는 이 형식도 그대로 읽습니다.
**강의계획서**
<table>
<tr><th colspan="2">강좌명</th><th colspan="2"></th><th>강사명</th></tr>
<tr><td colspan="2">강의시간</td><td colspan="2"></td><td></td></tr>
<tr><td colspan="5">교육과정세부내역</td></tr>
<tr><td colspan="2">수강자격</td><td colspan="3"></td></tr>
<tr><td colspan="2">교육목적</td><td colspan="3"></td></tr>
변환한 md 파일 전체는 아래에서 받아 직접 비교해 볼 수 있습니다.
이미지로만 된 PDF는 kordoc의 글자 인식 옵션을 켜야 합니다. 처음 쓸 때 인식 모델을 내려받느라 3쪽에 2분 남짓 걸렸습니다. 쪽수가 많으면 시간이 꽤 걸리니 필요한 쪽만 지정하는 편이 낫습니다.
어떤 걸 쓰면 될까
- 한글 파일, 공문서·공고문 PDF, 스캔 자료가 있다 → kordoc
- 워드·엑셀·PPT만 있다 → 둘 다 괜찮습니다. 이미 파이썬을 쓰고 있다면 MarkItDown이 간편합니다.
- 음성 파일이나 유튜브 영상의 글을 뽑고 싶다 → MarkItDown(이 기능은 이번에 시험하지 않았습니다)
둘 다 설치해 두고 Claude에게 문서 종류에 따라 골라 쓰게 하면 가장 편합니다.
가장 쉬운 방법: Claude Code에 맡기기
명령어를 몰라도 됩니다. Claude Code에 아래처럼 요청하면 도구 설치부터 변환, 결과 점검까지 대신 합니다. 대괄호 안만 내 상황에 맞게 바꿔 쓰면 됩니다.
[문서가 있는 폴더 경로]에 있는 …
프롬프트 전체 보기와 복사는 회원에게 열려 있어요
확인 중…바꾼 md 파일은 그대로 Claude에게 첨부하거나 작업 폴더에 넣어 두고 쓰면 됩니다.
첨부한 md 파일은 [문서…
프롬프트 전체 보기와 복사는 회원에게 열려 있어요
확인 중…명령어로 직접 바꾸려면
터미널을 써 본 분이라면 직접 실행해도 됩니다.
MarkItDown (파이썬 3.10 이상 필요)
pip install "markitdown[all]"
markitdown 문서.docx -o 문서.md
kordoc (Node.js 20 이상 필요)
npx kordoc 문서.hwp -o 문서.md
npx kordoc 스캔본.pdf --ocr -p 1-3 -o 스캔본.md
두 번째 줄의 -p 1-3은 1~3쪽만 바꾸라는 뜻입니다.
바꾼 뒤 확인할 것
표의 칸이 원본과 같은 자리에 있는…
체크리스트 전체는 회원에게 열려 있어요
확인 중…참고할 점
- 결과는 위에 적은 버전과 뉴런이 시험한 문서 7개 기준입니다. 문서 모양에 따라 결과가 달라질 수 있습니다.
- 두 도구 모두 내 컴퓨터에서 변환합니다. 다만 kordoc의 글자 인식 기능은 처음 쓸 때 인식 모델을 인터넷에서 내려받습니다.
- 변환은 자유롭게 할 수 있어도, 문서를 쓰고 나누는 것은 원래 자료의 이용 조건을 따라야 합니다.


