Markdown Converter
uvx markitdown을 사용하여 파일을 Markdown으로 변환합니다. 별도 설치가 필요 없습니다.
기본 사용법
# 표준 출력으로 변환
uvx markitdown input.pdf
# 파일로 저장
uvx markitdown input.pdf -o output.md
uvx markitdown input.docx > output.md
# 표준 입력에서
cat input.pdf | uvx markitdown
지원 형식
- 문서: PDF, Word (.docx), PowerPoint (.pptx), Excel (.xlsx, .xls)
- 웹/데이터: HTML, CSV, JSON, XML
- 미디어: 이미지 (EXIF + OCR), 오디오 (EXIF + 전사)
- 기타: ZIP (내부 파일 반복 처리), YouTube URL, EPub
옵션
-o OUTPUT # 출력 파일
-x EXTENSION # 파일 확장자 힌트 (표준 입력용)
-m MIME_TYPE # MIME 유형 힌트
-c CHARSET # 문자셋 힌트 (예: UTF-8)
-d # Azure Document Intelligence 사용
-e ENDPOINT # Document Intelligence 엔드포인트
--use-plugins # 타사 플러그인 활성화
--list-plugins # 설치된 플러그인 나열
예제
# Word 문서 변환
uvx markitdown report.docx -o report.md
# Excel 스프레드시트 변환
uvx markitdown data.xlsx > data.md
# PowerPoint 프레젠테이션 변환
uvx markitdown slides.pptx -o slides.md
# 파일 유형 힌트와 함께 변환 (표준 입력용)
cat document | uvx markitdown -x .pdf > output.md
# Azure Document Intelligence를 사용한 향상된 PDF 추출
uvx markitdown scan.pdf -d -e "https://your-resource.cognitiveservices.azure.com/"
참고 사항
- 출력 시 문서 구조(제목, 표, 목록, 링크)가 유지됩니다.
- 첫 실행 시 종속성을 캐싱하며, 이후 실행은 더 빠릅니다.
- 추출이 어려운 복잡한 PDF의 경우
-d옵션과 함께 Azure Document Intelligence를 사용하세요.