Ivan2993/markitdown

markitdown은(는) 무엇을 하나요?

📝 MarkItDown의 다양한 도구와 MCP 서버를 활용하여 애플리케이션에 마크다운을 원활하게 통합하고 LLM 호환성을 확보하세요.

개요

MarkItDown은 다양한 문서 형식을 마크다운으로 변환하는 강력한 라이브러리입니다. 이 스킬은 MCP 서버를 비롯한 여러 진입점을 제공하여 LLM과의 통합을 단순화합니다.

주요 기능

• 다중 형식 지원: PDF, Microsoft Office 문서, HTML, 이미지 등 다양한 형식을 마크다운으로 변환
• MCP 서버 통합: Model Context Protocol을 통한 LLM 호환성 제공
• CLI 도구: 명령줄에서 직접 사용 가능한 도구
• Python API: 프로그래밍 방식으로 통합 가능

설치 방법

pip install markitdown

또는

# 저장소 클론
gh repo clone Ivan2993/markitdown
cd markitdown

# 의존성 설치
pip install -r requirements.txt

사용 예시

CLI 사용

markitdown input.pdf -o output.md
markitdown input.docx --output output.md

Python API 사용

from markitdown import MarkItDown

md = MarkItDown()
result = md.convert("path/to/document.pdf")
print(result.text_content)

MCP 서버 실행

markitdown-mcp

지원 형식

형식	확장자	지원 수준
PDF	.pdf	완벽 지원
Word	.docx	완벽 지원
PowerPoint	.pptx	텍스트 및 구조
Excel	.xlsx	표 데이터
HTML	.html	완벽 지원
이미지	.png, .jpg	OCR 기반

구성 옵션

환경 변수 또는 설정 파일을 통해 동작을 구성할 수 있습니다.

변수	설명	기본값
MARKITDOWN_PORT	MCP 서버 포트	8080
MARKITDOWN_LOG_LEVEL	로그 레벨	INFO

통합 예시

Claude Code와 함께 사용

# Claude Code 에이전트에서 MarkItDown MCP 서버 활용
# MCP 서버를 시작한 후, Claude Code에서 도구 호출

Cursor와 함께 사용

Cursor의 AI 기능과 MarkItDown을 결합하여 문서 처리 자동화

참고 자료

• MarkItDown 공식 문서
• MCP 프로토콜
• 문제 보고