markitdown은(는) 무엇을 하나요?
파일과 오피스 문서를 마크다운으로 변환합니다. PDF, DOCX, PPTX, XLSX, 이미지(OCR 포함), 오디오(전사 포함), HTML, CSV, JSON, XML, ZIP, YouTube URL, EPUB 등을 지원합니다.
개요
이 스킬은 markitdown 라이브러리를 사용하여 파일을 마크다운으로 변환합니다. 파일이 주어지면 확장자를 기반으로 적절한 변환기를 자동으로 선택하고 콘텐츠를 출력합니다.
변환 가능한 형식
- PDF – 텍스트 추출 (레이아웃 보존)
- DOCX – Word 문서 변환
- PPTX – PowerPoint 프레젠테이션
- XLSX – Excel 스프레드시트
- 이미지 – OCR (광학 문자 인식)
- 오디오 – 음성-텍스트 변환
- HTML – 웹 페이지를 마크다운으로
- CSV / JSON / XML – 구조화된 데이터
- ZIP – 압축 해제 및 변환
- YouTube – URL에서 자막 가져오기
- EPub – 전자책 변환
사용법
CLI
uvx markitdown /path/to/file.pdf > output.md
온라인 파일의 경우:
uvx markitdown https://example.com/document.pdf > output.md
Python 스크립트
from markitdown import MarkItDown
md = MarkItDown()
result = md.convert("/path/to/file.pdf")
print(result.text_content)
에이전트 사용법
파일 경로를 제공하면 AI 에이전트가 자동으로 변환을 수행합니다:
Can you convert this PDF to markdown?
/path/to/document.pdf
AI agent converts it and returns markdown content
지원 도구
이 스킬은 다음에서 작동합니다:
- Claude Code
- Cursor
- Codex
- Windsurf
- Cline
- Aider
- 모든 유사한 AI 코딩 도구
LLM 맥락
AI가 markitdown을 사용할 때는 다음 지침을 따르세요:
- 파일 경로가 주어지면 해당 형식을 감지하고
uvx markitdown <파일경로>실행 - 올바른 리디렉션으로 출력 캡처 (CLI 사용 또는 Python API 호출)
- 변환된 마크다운을 정리하여 사용자에게 제시
- 대용량 파일은 성능을 위해 청크 단위로 처리
통합
- 로컬: 로컬 시스템에 설치된 파일과 함께 작동
- 원격: HTTP/HTTPS URL을 직접 지원
- 스트리밍: 문서의 스트리밍 처리 지원
노트
- 이미지 OCR에는
pytesseract및 Tesseract 설치 필요 - 오디오 전사에는
speechrecognition및 백엔드 필요 - YouTube 변환에는 YouTube 자막 API 사용
- 변환 정확도는 소스 품질에 따라 달라짐
라이선스
MIT