MarkItDown: 파일과 오피스 문서를 Markdown으로 변환하는 유용한 AI 도구!
MarkItDown이란 무엇인가요?
MarkItDown은 Microsoft가 지원하는 오픈소스 도구로, PDF, Word, Excel, PowerPoint, 이미지, 오디오, 웹페이지 등 다양한 파일 형식을 Markdown 형식으로 변환할 수 있습니다. 또한 LLM 애플리케이션에 최적화되어 있어, 출력 콘텐츠는 사람이 읽기 적합할 뿐만 아니라 LLM의 이상적인 입력 형식이기도 합니다.

MarkItDown 기능 특징
다양한 형식 지원: PDF, Word, Excel, ppt, 이미지(OCR 인식 포함), 오디오(음성-텍스트 변환), HTML, 웹페이지(예: YouTube 링크) 등을 구조화된 Markdown으로 변환할 수 있습니다. 제목 계층, 테이블 구조 등 핵심 콘텐츠를 유지하여 ai가 이해하고 분석하기에 적합합니다.
MCP 프로토콜 통합: MCP 서버로서 AI 도구(예: Claude Desktop)가 표준 프로토콜을 통해 파일 변환 기능을 호출할 수 있게 하며, 프로그래밍 없이도 "음성 명령을 통한 파일 처리"를 구현할 수 있습니다. 예를 들어, 사용자가 "이 PDF를 Markdown으로 변환해 주세요"라고 말하면 AI가 자동으로 MarkItDown을 호출하여 변환을 완료합니다.
MarkItDown 활용 시나리오
학술 연구: 논문, 문헌을 빠르게 Markdown으로 변환하여 텍스트 분석을 용이하게 합니다.
사무 자동화: 회의 녹음, PPT 등을 구조화된 노트로 변환합니다.
AI 워크플로우: LLM과 결합하여 "음성 명령→파일 처리→콘텐츠 요약" 전체链路 자동화를 구현합니다.
MarkItDown 설치 및 사용 방법은?
1. 설치 및 시작
명령줄 모드:
pip install markitdown-mcp markitdown-mcp # 启动 STDIO 模式 markitdown-mcp --sse --host 127.0.0.1 --port 3001 # 启动 SSE 服务[2,4,5](@ref)
Docker 배포:
docker build -t markitdown-mcp:latest . docker run -it --rm markitdown-mcp:latest # 默认 STDIO 模式 docker run -it --rm -v /本地目录:/workdir markitdown-mcp:latest # 挂载本地文件[4,5](@ref)
2. Claude Desktop 설정
claude_desktop_config.json에 다음 설정을 추가하여 MarkItDown MCP 서비스를 사용합니다.
{
"mcpServers": {
"markitdown": {
"command": "docker",
"args": ["run", "--rm", "-i", "-v", "/本地目录:/workdir", "markitdown-mcp:latest"]
}
}
}설정 후 Claude는 파일 변환 기능을 직접 호출할 수 있습니다.
3. Python API 호출
from markitdown import MarkItDown
md = MarkItDown(enable_plugins=True)
result = md.convert("input.pdf") # 转换为 Markdown 文本
print(result.text_content)llm_client 매개변수를 통해 LLM 모델(예: GPT-4o)을 연결하여 출력을 최적화할 수 있습니다.
github:https://github.com/microsoft/markitdown/tree/main/packages/markitdown-mcp
대본 기획 도우미▸
AI 앱
AI 뉴스 