MarkItDown: 파일과 오피스 문서를 Markdown으로 변환하는 유용한 AI 도구! 126

小编 ·

MarkItDown: 파일과 오피스 문서를 Markdown으로 변환하는 유용한 AI 도구!

MarkItDown은 Microsoft가 지원하는 오픈소스 도구로, PDF, Word, Excel, PowerPoint, 이미지, 오디오, 웹페이지 등 다양한 파일 형식을 Markdown으로 변환할 수 있습니다. LLM 애플리케이션에 최적화되어 있어 사람이 읽기 쉬울 뿐만 아니라 LLM의 이상적인 입력 형식인 출력 콘텐츠를 생성합니다.

MarkItDown: 파일과 오피스 문서를 Markdown으로 변환하는 유용한 AI 도구!

MarkItDown이란 무엇인가요?

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

MarkItDown MCP:웹페이지 링크, 로컬 파일 및 데이터를 Markdown 형식으로 변환.jpg

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