AI에게 엑셀을 줬더니 표가 엉켰다면

복사해 붙인 문서, AI 눈에는 이렇게 보여요

품목 수량 단가 합계로고 디자인 1 800,000 800,000명함 인쇄 500 120 60,000홈페이지 첫 화면 1 1,200,000 1,200,000

3분기 매출 보고분기 매출

## 견적| 품목 | 수량 | 단가 | 합계 || --- | --- | --- | --- || 로고 디자인 | 1 | 800000 | 800000 || 명함 인쇄 | 500 | 120 | 60000 || 홈페이지 첫 화면 | 1 | 1200000 | 1200000 |## 일정| ... |

<!-- Slide number: 1 --># 3분기 매출 보고<!-- Slide number: 2 --># 분기 매출### Chart: 분기 매출| Category | 매출 || 1분기 | ... |### Notes:3분기는 신제품 덕분

README와 저장소의 변환기 코드가 만드는 모양을 보여 주려고 저희가 그린 예시예요. 견적서와 보고서 내용은 지어낸 것이고, 가운데 칸의 붙여 넣은 모양은 쓰는 프로그램에 따라 달라요. 실제 결과는 파일 구조와 설치한 부품에 따라 달라져요.

한눈에

어떻게 작동하나요

1. 파일 종류마다 다른 변환기가 맡아요. 엑셀은 시트마다 "## 시트 이름" 제목 아래 표를 만들고, PPT는 슬라이드마다 <!-- Slide number: 1 --> 표시를 넣고 제목은 #, 차트는 ### Chart, 발표자 메모는 ### Notes: 로 적어요(저장소의 변환기 코드 기준).2. 필요한 부품만 깔 수 있어요. [all] 은 모든 형식을, [pdf, docx, pptx] 처럼 고르면 그 형식만 깔아요. 오래된 엑셀(xls), 아웃룩 메일, 음성 받아쓰기, 유튜브 자막도 따로 고를 수 있어요.3. 더 정밀해야 하면 클라우드를 붙여요. Azure 문서 인텔리전스나 Azure 콘텐츠 이해(Content Understanding)를 쓰면 스캔한 PDF, 복잡한 표, 영상까지 다루고, 청구서 금액 같은 칸을 뽑아 글머리(YAML)에 적어요. 기본 변환기는 내 컴퓨터에서만 돌아 돈이 들지 않고, Azure 를 쓰면 변환할 때마다 요금이 나가요.4. 플러그인으로 넓혀요. 플러그인은 기본으로 꺼져 있어요. markitdown-ocr 플러그인은 PDF, 워드, PPT, 엑셀 안에 든 그림 속 글자를 AI 비전 모델로 읽어요.

할 수 있는 일

바로 쓸 수 있나요

시작하기

1. 준비물과 가상환경

   파이썬 3.10부터 3.14까지 돼요. 다른 프로그램과 부품이 꼬이지 않게 가상환경을 먼저 만들라고 README가 권해요.

   python -m venv .venv
   source .venv/bin/activate

   복사
2. 설치

   모든 형식을 한 번에 받으려면 [all] 을 붙여요.

   pip install 'markitdown[all]'

   복사
3. 파일 하나 바꾸기

   -o 뒤에 저장할 파일 이름을 써요. 만든 .md 파일을 AI 대화창에 넣으면 돼요.

   markitdown path-to-file.pdf -o document.md

   복사
4. 파이썬 코드에서

   여러 파일을 한꺼번에 바꾸거나 다른 프로그램에 끼워 넣을 때 써요.

   from markitdown import MarkItDown
   
   md = MarkItDown(enable_plugins=False)
   result = md.convert("test.xlsx")
   print(result.markdown)

   복사
5. 클로드 데스크톱에 연결(선택)

   markitdown-mcp 폴더에서 도커 이미지를 만든 뒤, 클로드 데스크톱 설정 파일(claude_desktop_config.json)의 mcpServers 에 markitdown 을 넣어요. README는 클로드 데스크톱에는 도커로 돌리기를 권하고, 내 컴퓨터 폴더를 읽히려면 -v 로 폴더를 이어 주라고 적어요.

   docker build -t markitdown-mcp:latest .

   복사

파일을 넣으면 이렇게 나와요

README의 명령과 저장소 변환기 코드가 만드는 모양을 따라 저희가 그린 예시예요. 문서 내용, 그림 설명, 요약은 지어낸 것이에요. 실제 결과는 파일 구조, 설치한 부품, 연결한 AI 모델에 따라 달라져요.

비슷한 도구

마크잇다운은 여러 형식을 AI용 글로 바꾸는 데 집중하고, 코독은 한글 문서를, 스털링 PDF는 PDF 편집 자체를 맡아요(각 README 기준).

주의할 점

1. 마크잇다운은 실행한 사람의 권한으로 파일과 주소를 읽어요. README는 믿을 수 없는 입력을 그대로 넣지 말고, 서버에서 쓴다면 파일 경로와 접속할 주소를 제한하고, 필요한 만큼만 여는 convert_local(), convert_stream() 같은 함수를 쓰라고 경고해요.
2. MCP 서버(markitdown-mcp)는 내 컴퓨터에서, 믿을 수 있는 AI 앱과만 쓰라고 README가 적어요. HTTP 방식으로 켜도 기본은 이 컴퓨터(localhost)에만 열리고, 보안 문제를 모르면 다른 주소로 열지 말라고 해요.
3. 스캔한 PDF처럼 글자가 그림으로 된 문서는 README가 Azure 클라우드 변환이나 markitdown-ocr 플러그인을 안내해요. 둘 다 바깥 서비스로 파일 내용을 보내고 요금이 들 수 있으니, 회사 문서라면 보내도 되는지 먼저 확인하세요.
4. Azure 를 쓰면 convert() 한 번이 요금이 나가는 호출 한 번이에요. README는 cu_file_types 로 PDF처럼 꼭 필요한 형식만 클라우드로 보내라고 권해요.
5. 지원 목록에 한글(HWP) 문서는 없어요. 한글 문서는 따로 바꾸는 도구가 필요해요. 플러그인은 다른 사람이 만든 것이라 깔기 전에 저장소를 확인하세요.

더 보기

마이크로소프트의 오토젠(AutoGen) 팀이 만들었어요. 저장소는 라이브러리, 터미널 도구, MCP 서버만 다루고 웹 서비스나 데스크톱 앱은 받지 않는다고 적어요.

PyPI 패키지 ↗MCP 서버 안내(markitdown-mcp) ↗OCR 플러그인 안내(markitdown-ocr) ↗README의 보안 안내 ↗깃허브 저장소 ↗

낯선 말

1. 마크다운 · # 제목, - 목록, | 표 | 처럼 기호 몇 개로 글의 구조를 표시하는 쓰기 방식이에요
2. 토큰 · AI가 글을 읽을 때 쪼개는 단위예요. 적을수록 빠르고 싸요
3. MCP · AI 앱이 바깥 도구를 불러 쓰게 하는 연결 규칙이에요
4. 가상환경 · 프로젝트마다 파이썬 부품을 따로 담아 두는 칸이에요. 다른 프로그램과 꼬이지 않게 해요
5. OCR · 그림 속 글자를 읽어 글로 바꾸는 기술이에요
6. RAG · AI가 답하기 전에 내 문서에서 관련 부분을 찾아 읽게 하는 방식이에요
7. EXIF · 사진 파일 안에 든 찍은 날짜, 크기 같은 정보예요