MarkItDown은 워드·PDF·엑셀 등을 AI가 읽기 좋은 마크다운 텍스트로 바꾸는 마이크로소프트 오픈소스 도구로, 직접 쓰려면 파이썬·명령줄이 필요합니다.
MarkItDown이 뭔가요
복잡한 문서 파일을 'AI가 읽기 좋은 텍스트'로 바꿔 주는 마이크로소프트 변환 도구입니다.
- Markdown마크다운
- 제목·목록·표 같은 모양을 간단한 기호로 표시하는 가벼운 텍스트 형식입니다. 사람도 읽기 쉽고 AI도 소화하기 좋아서 많이 씁니다.
- Open source오픈소스
- 프로그램의 설계도(코드)를 누구나 보고 쓸 수 있게 공개한 것입니다. MarkItDown은 MIT 라이선스라 코드 사용은 무료입니다.
- CLI / command line명령줄
- 마우스 클릭 대신 글자(명령어)를 입력해 컴퓨터에 일을 시키는 방식입니다. MarkItDown을 직접 쓰려면 이 방식이 필요합니다.
나한테 맞는 도구일까
솔직히, 비개발자에겐 '파이썬·명령줄 설치'라는 첫 장벽이 있습니다.
MarkItDown은 개발자, 또는 명령줄이 익숙한 사람을 염두에 두고 만들어진 도구입니다. 비개발자에게도 쓸모가 있지만, 시작 전에 두 가지를 솔직히 알아두는 게 좋습니다.
- 파이썬과 명령줄이 필요합니다 — 공식 설치 방법은
pip install 'markitdown[all]'같은 명령줄 입력입니다(공식 문서대로 따옴표를 그대로 붙이는 게 안전합니다 — 맥 기본 터미널에서는 따옴표가 없으면 오류가 날 수 있습니다). 마우스로 클릭하는 설치 화면이 아니라, 글자 명령으로 설치하고 실행합니다. 파이썬(3.10 이상)을 한 번도 안 깔아봤다면 여기서 막힐 수 있습니다. - 'AI용' 텍스트를 만드는 도구입니다 — 공식 설명대로, 사람이 그대로 읽을 예쁜 문서를 만드는 게 아니라 AI에게 넣기 좋은 텍스트를 만드는 데 초점이 있습니다. 단순히 'PDF를 워드로 바꾸고 싶다' 같은 목적이라면 다른 변환 서비스가 더 맞을 수 있습니다.
그래서 '문서를 AI에 자주 넣어 쓰고, 명령줄 정도는 시도해 볼 의향이 있는 사람'에겐 유용하지만, '가끔 파일 하나 변환' 정도라면 굳이 설치까지 갈 필요가 없을 수 있습니다.
비개발자는 MarkItDown을 절대 못 쓰나요?
꼭 그렇진 않습니다. 다만 '파이썬·명령줄 설치'라는 진입 문턱이 있어 일반 웹 변환 사이트보다 어렵습니다. 명령줄이 부담스럽다면, 평소 쓰는 AI 챗봇에 파일을 그냥 첨부해 보거나(아래 '더 쉬운 입구' 참고), 명령줄에 익숙한 동료·지인에게 한 번만 설치를 부탁하는 것도 방법입니다.
문서를 AI에 자주 넣는 분
여러 보고서·자료를 AI에게 자주 요약·분석시키고, 깔끔한 텍스트로 미리 다듬어 두고 싶고, 명령줄 설치 정도는 시도해 볼 의향이 있는 분에게 잘 맞습니다.
파일 한두 개만 변환하면 되는 분
어쩌다 한 번 파일을 바꾸는 정도라면 설치 부담이 큽니다. AI 챗봇에 파일을 바로 첨부하거나 웹 변환 서비스를 쓰는 게 더 빠르고 쉽습니다.
무엇을, 어디까지 해주나
여러 파일을 한 가지 형식(마크다운 텍스트)으로 모아 줍니다 — 단, 한계도 정직히.
공식 저장소 기준, MarkItDown은 꽤 다양한 파일을 받아 하나의 깔끔한 텍스트(마크다운)로 바꿔 줍니다. 종류가 제각각인 자료를 'AI가 읽기 좋은 같은 모양'으로 통일해 준다는 점이 핵심입니다. 다만 모든 변환이 완벽한 건 아니라는 점도 함께 알아두세요.
MarkItDown이 바꿔 줄 수 있는 대표 파일(공식 기준)
- 워드(.docx)·파워포인트(.pptx)·엑셀(.xlsx) 등 오피스 문서
- PDF 파일 — 안의 텍스트를 뽑아 정돈
- 이미지 — 안의 정보(EXIF)나 글자 인식(OCR) 등
- 오디오 — 메타정보, 그리고 옵션 설정 시 음성 받아쓰기
- HTML·CSV·JSON·XML 같은 텍스트·데이터 파일, 그리고 ZIP·EPUB·유튜브 URL 등
무료인가요? 비용과 라이선스 정직하게
코드는 무료(MIT)지만, '실행에 돈이 드는 부분'이 따로 있을 수 있습니다.
| 항목 | 내용(변동될 수 있음 — 공식 확인) |
|---|---|
| 라이선스 | MIT 라이선스 — 코드를 무료로 보고·쓰고·고칠 수 있는 자유로운 오픈소스 |
| 프로그램 자체 비용 | 무료. pip 설치도 무료이고 가입이 따로 필요 없음 |
| AI 연동 비용 | 이미지 설명 생성에 OpenAI 같은 외부 AI를 붙이거나 Azure(마이크로소프트 클라우드)를 연동하면, 그 AI·클라우드 이용료는 별도로 듦 |
| 성숙도 | 공식 PyPI 표기(Development Status)상 베타(Beta) 단계 — 기능·동작이 계속 바뀔 수 있음 |
| 쓰는 곳 | 명령줄(맥·윈도우·리눅스), 또는 파이썬 코드 안에서. Docker로도 실행 가능 |
오픈소스니까 완전 공짜로 뭐든 무제한이죠?
기본 변환 자체는 무료가 맞습니다(MIT 라이선스). 다만 이미지 설명을 만들거나 더 정교한 추출을 위해 OpenAI·Azure 같은 외부 AI/클라우드를 연동하면 그쪽 이용료가 별도로 듭니다. 또 공식 PyPI 표기상 아직 베타(개발 중) 단계이고, 공식 README도 변환 결과가 늘 완벽하진 않다고 밝힙니다. '코드는 공짜, 단 고급 기능은 비용·확인이 필요'로 이해하면 정확합니다.
시작하는 법 — 설치부터 첫 변환까지
흐름은 '파이썬 준비 → 명령줄 설치 → 파일 변환 → 결과 확인'입니다.
1단계 · 파이썬(3.10 이상) 준비
MarkItDown은 파이썬 위에서 돕니다. 내 컴퓨터에 파이썬 3.10 이상이 깔려 있어야 합니다. 없다면 먼저 파이썬을 설치하세요. 이 단계가 비개발자에겐 가장 큰 첫 문턱입니다.
2단계 · 명령줄(터미널) 열기
맥은 '터미널', 윈도우는 'PowerShell' 앱을 엽니다. 글자를 입력하는 명령 창이 뜨면 준비 완료입니다.
3단계 · 설치 명령 붙여넣기
명령 창에 공식 문서에 적힌 그대로 pip install 'markitdown[all]' (따옴표 포함)을 붙여넣고 실행하면 설치됩니다. 맥 기본 터미널에서는 따옴표를 빼면 오류가 날 수 있으니 그대로 복사하세요. 명령은 바뀔 수 있으니 공식 PyPI·GitHub에서 최신 설치법을 확인하세요.
4단계 · 파일 한 개 변환해 보기
명령 창에 markitdown 내파일.pdf > 결과.md 처럼 입력하면, 그 파일이 마크다운 텍스트(결과.md)로 저장됩니다. 우선 중요하지 않은 연습용 파일로 해보세요.
5단계 · 결과를 원본과 비교 확인
만들어진 결과.md를 열어 원본과 비교합니다. 표·숫자·중요한 문장이 잘 들어갔는지 확인하고, 빠진 게 있으면 그 부분은 직접 보완하세요.
오늘 해볼 것 — 부담 없이 한 걸음
꼭 설치하지 않아도 됩니다. '나한테 필요한 도구인지'부터 가볍게 가늠해 보세요.
1단계 · 공식 저장소 둘러보기
github.com/microsoft/markitdown 을 열어 '무엇을 하는 도구인지'와 어떤 파일을 지원하는지 소개를 훑어봅니다. 영어가 부담되면 브라우저 번역을 켜세요.
2단계 · 내게 정말 필요한지 체크
'나는 문서를 AI에 자주 넣어 쓰나?', '명령줄·파이썬 설치를 시도할 의향이 있나?' 두 질문에 스스로 답해 봅니다. 둘 다 아니라면 굳이 설치할 필요는 없습니다.
3단계 · 더 쉬운 입구 먼저 시도
설치가 부담되면, 평소 쓰는 ChatGPT·Claude 같은 AI 챗봇에 파일을 그냥 첨부해 '이 문서 요약해줘'라고 해보세요. 많은 경우 이 정도로 충분합니다.
4단계 · 그래도 필요하면 연습용으로
여러 파일을 반복적으로 다뤄야 해 진짜 필요하다면, '시작하는 법'을 따라 연습용 파일 하나로 먼저 설치·변환을 시험해 봅니다.
- 설치를 진행한다면, 명령어는 기억에 의존하지 말고 공식 PyPI/GitHub에서 그대로 복사하기
- 처음엔 중요하지 않은 연습용 파일로 변환하고, 결과를 원본과 꼭 비교하기
- 회사 기밀·개인정보 문서는 외부 AI 연동 없이 쓸지부터 보안 규정으로 확인하기
| 이걸 했으면 첫걸음 끝 | 확인 |
|---|---|
| 공식 저장소에서 '무엇을 하는 도구인지' 확인했다 | ☐ |
| 'AI에 문서를 자주 넣나 / 명령줄을 시도할 의향이 있나'를 판단했다 | ☐ |
| 설치 전에 AI 챗봇에 파일 첨부 같은 '더 쉬운 입구'를 먼저 시도했다 | ☐ |
| 설치한다면 연습용 파일로 먼저 변환·확인하기로 했다 | ☐ |
자주 묻는 질문
MarkItDown은 무료인가요?
프로그램 코드 자체는 MIT 라이선스의 오픈소스라 무료로 쓸 수 있고, pip 설치에도 가입이나 비용이 없습니다. 다만 이미지 설명 생성에 OpenAI 같은 외부 AI를 붙이거나 Azure 같은 클라우드를 연동하면 그 AI·클라우드 이용료는 별도로 듭니다. 구체적 비용·약관은 공식에서 확인하세요.
코딩을 전혀 모르는데 쓸 수 있나요?
쓸 수는 있지만 권장되진 않습니다. 공식 설치 방법이 파이썬(3.10 이상)과 명령줄(pip) 입력이라 비개발자에겐 문턱이 있습니다. 부담된다면 평소 쓰는 AI 챗봇에 파일을 바로 첨부하거나, 명령줄에 익숙한 동료에게 설치를 한 번 부탁하는 편이 쉬운 입구입니다.
어떤 파일을 마크다운으로 바꿀 수 있나요?
공식 기준으로 워드(.docx)·파워포인트(.pptx)·엑셀(.xlsx) 같은 오피스 문서, PDF, 이미지, 오디오, HTML·CSV·JSON·XML 같은 텍스트·데이터 파일, ZIP·EPUB·유튜브 URL 등 꽤 다양합니다. 다만 일부 형식은 옵션 설치가 필요할 수 있으니 공식 안내를 확인하세요.
변환 결과가 원본과 똑같이 완벽한가요?
그렇진 않습니다. 공식도 '사람이 볼 고품질 변환보다는 AI 같은 텍스트 분석 도구에 넣기 위한 것'이라고 밝힙니다. 표가 복잡하거나 디자인이 화려한 문서는 일부가 빠지거나 어긋날 수 있으니, 바뀐 텍스트는 원본과 비교해 한 번 확인하세요.
그냥 PDF를 워드로 바꾸고 싶은 건데 이 도구가 맞나요?
딱 맞진 않을 수 있습니다. MarkItDown은 'AI가 읽기 좋은 텍스트(마크다운)'를 만드는 데 초점이 있어, 사람이 그대로 볼 예쁜 워드 문서를 만드는 용도와는 다릅니다. 단순 문서 변환이 목적이라면 다른 변환 서비스가 더 어울릴 수 있습니다.
회사 문서를 변환해도 안전한가요?
기본 변환은 내 컴퓨터에서 이뤄지지만, 외부 AI(OpenAI 등)나 클라우드를 연동하면 문서 내용이 외부로 전송될 수 있습니다. 기밀·개인정보가 든 자료라면 먼저 사내 보안 규정을 확인하고, 외부 연동 없이 기본 변환만 쓸지 신중히 정하세요.
출처와 확인 경계
기능·지원 파일·설치 방법·라이선스는 MarkItDown 공식 GitHub 저장소(README)와 공식 PyPI 페이지를 기준으로 정리했습니다(2026-06-07 기준). 화면·명령어·요금(특히 Azure 같은 클라우드 연동)·라이선스 조건은 업데이트로 바뀔 수 있으니 아래 내용은 큰 흐름으로 참고하고, 실제 진행 전 공식에서 최신 정보를 한 번 확인하세요. 또 MarkItDown이 바꾼 텍스트나 그 텍스트를 넣어 AI가 만든 결과가 항상 맞는 것은 아니므로, 받은 결과는 그대로 믿기보다 원본과 비교해 한 번 확인하는 게 좋습니다.