자료실
가이드문서·리서치

한글⁠·PDF⁠·워드 문서를 md 파일로 바꾸는 법 — MarkItDown과 kordoc 비교

고른 이유AI에게 문서를 읽힐 때 md 파일로 주면 표와 제목 구조가 살아 있어 결과가 안정적입니다. 많이 알려진 MarkItDown이 한국 문서에서도 잘 되는지 궁금해 실제 파일 7개로 비교했습니다.

한 줄로 말하면

워드·엑셀·PPT만 바꾼다면 마이크로소프트의 MarkItDown으로 충분합니다. 한글(HWP·HWPX) 파일이나 한국 공문서 PDF가 섞여 있다면 kordoc이 훨씬 정확했습니다. 두 도구 모두 무료이고 내 컴퓨터 안에서 변환하므로 문서가 밖으로 나가지 않습니다.

이런 분께

  • 회사 문서나 공고문을 Claude 같은 AI에게 읽혀 요약·분석하려는 분
  • 한글 파일을 AI가 읽지 못해 매번 복사해 붙여 넣고 있는 분
  • 자료를 md 파일로 모아 AI 작업 폴더나 스킬 자료로 쓰려는 분

왜 md 파일로 바꾸나

md(마크다운)는 제목·목록·표를 기호 몇 개로 표시하는 글 파일입니다. 한글이나 PDF를 그대로 주면 AI가 표와 단락을 섞어 읽기 쉽지만, md로 바꿔 주면 어디가 제목이고 어디가 표인지 구조가 그대로 전달됩니다. 파일 크기도 작아서 같은 한도 안에서 더 많은 자료를 읽힐 수 있습니다.

도구 두 가지

MarkItDownkordoc
만든 곳마이크로소프트(공개 프로젝트)국내 개발자 공개 프로젝트
비용·사용 조건무료, MIT 라이선스(상업적 이용 가능)무료, MIT 라이선스(상업적 이용 가능)
바꿀 수 있는 문서워드·엑셀·PPT·PDF·이미지·음성·HTML 등한글(HWP·HWPX)·PDF·워드·엑셀·PPT·이미지
한글 파일지원하지 않음지원
스캔·이미지 PDF글자를 읽지 못함글자 인식(OCR) 옵션 있음
설치에 필요한 것파이썬 3.10 이상Node.js 20 이상
공식 주소github.com/microsoft/markitdownpubax.org/kordoc · GitHub

직접 바꿔 본 결과

뉴런이 실제 문서 7개를 두 도구로 바꿔 봤습니다(2026년 11월 17일, MarkItDown 0.1.9·kordoc 4.24.82 기준).

문서MarkItDownkordoc
워드(표가 있는 강의 자료)제목·목록·표 모두 유지제목·목록·표 모두 유지
엑셀(자가진단표)표로 바뀌지만 빈 칸에 "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 파일 전체는 아래에서 받아 직접 비교해 볼 수 있습니다.

doc2md-examples.zip
같은 공고문 PDF를 MarkItDown·kordoc으로 바꾼 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의 글자 인식 기능은 처음 쓸 때 인식 모델을 인터넷에서 내려받습니다.
  • 변환은 자유롭게 할 수 있어도, 문서를 쓰고 나누는 것은 원래 자료의 이용 조건을 따라야 합니다.

저작권·출처 문의 newrun.cs@gmail.com

자료를 넘어 나만의 도구를 직접 만들고 싶다면 —

교육 프로그램 보기 →

함께 보면 좋은 자료

자료실 전체 →