Repolode
microsoft

microsoft/markitdown

PDF, Office 문서, HTML, 이미지, 오디오 등을 Markdown으로 변환해 LLM 및 텍스트 분석 파이프라인에 활용하는 Python 유틸리티입니다.

스타
191,206
포크
14,233
열린 이슈
740
마지막 커밋
16일 전

어떤 프로젝트인가요?

MarkItDown은 PDF, PowerPoint, Word, Excel, HTML, CSV, JSON, XML, EPUB, ZIP 아카이브 등의 파일을 Markdown으로 변환하는 경량 Python 라이브러리이자 명령줄 도구입니다. 제목, 목록, 표, 링크와 같은 문서 구조를 보존해 결과물을 대규모 언어 모델이나 다른 텍스트 분석 도구에 입력할 수 있도록 설계되었습니다.

사람이 읽기 좋은 형태를 충실히 재현하기보다는 기계가 처리하기 좋은 결과물을 만드는 데 중점을 둡니다. 선택적 의존성을 통해 필요한 형식만 설치할 수 있으며, 클라우드 기반 추출에는 Azure Document Intelligence와 Azure Content Understanding을 사용할 수 있습니다. LLM 클라이언트로 이미지와 오디오를 처리해 설명을 생성할 수 있고, YouTube URL도 지원합니다.

서드파티 플러그인도 지원하며, 기본적으로 비활성화되어 있어 플래그를 지정해 활성화할 수 있습니다. Python 3.10~3.14가 필요합니다.

핵심 기능

  • 01PDF, Office 문서, HTML, 텍스트 형식 및 ZIP 아카이브를 Markdown으로 변환
  • 02출력에서 제목, 목록, 표, 링크를 보존
  • 03명령줄 인터페이스와 Python API 제공
  • 04선택적 extras를 통해 필요한 형식의 의존성만 설치
  • 05클라우드 추출을 위해 Azure Document Intelligence 및 Azure Content Understanding 지원
  • 06추가 형식을 위한 서드파티 플러그인 지원

활용 사례

  • LLM 프롬프트나 검색 파이프라인에 사용할 문서를 Markdown 컨텍스트로 준비
  • 텍스트 분석을 위해 Office 파일과 PDF를 일괄 변환
  • YouTube 자막이나 오디오 파일에서 텍스트 추출
  • 구조화된 문서 콘텐츠를 LangChain 또는 AutoGen 워크플로에 입력

빠른 시작

  1. 1

    모든 선택적 종속 항목을 포함해 pip로 설치하기

    pip install 'markitdown[all]'
  2. 2

    명령줄에서 파일을 Markdown으로 변환하기

    markitdown path-to-file.pdf -o document.md

사용 전 알아둘 점

  • 출력은 사람이 읽기 편한 형태로 고충실도 변환하는 것이 아니라, 텍스트 분석 및 LLM 파이프라인을 위한 것입니다.
  • Python 3.10~3.14가 필요합니다.
  • 이미지 설명, Document Intelligence, Content Understanding 등의 일부 기능에는 Azure 또는 LLM API 키가 필요하며 비용이 발생합니다.

토픽

자주 묻는 질문

markitdown은(는) 무엇인가요?
PDF, Office 문서, HTML, 이미지, 오디오 등을 Markdown으로 변환해 LLM 및 텍스트 분석 파이프라인에 활용하는 Python 유틸리티입니다. MarkItDown은 PDF, PowerPoint, Word, Excel, HTML, CSV, JSON, XML, EPUB, ZIP 아카이브 등의 파일을 Markdown으로 변환하는 경량 Python 라이브러리이자 명령줄 도구입니다. 제목, 목록, 표, 링크와 같은 문서 구조를 보존해 결과물을 대규모 언어 모델이나 다른 텍스트 분석 도구에 입력할 수 있도록 설계되었습니다.
markitdown은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
markitdown은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
markitdown은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. markitdown의 마지막 커밋은 2026년 10월 4일입니다.
markitdown은(는) 어디에 사용할 수 있나요?
LLM 프롬프트나 검색 파이프라인에 사용할 문서를 Markdown 컨텍스트로 준비 텍스트 분석을 위해 Office 파일과 PDF를 일괄 변환 YouTube 자막이나 오디오 파일에서 텍스트 추출 구조화된 문서 콘텐츠를 LangChain 또는 AutoGen 워크플로에 입력
markitdown는 어떻게 설치하나요?
모든 선택적 종속 항목을 포함해 pip로 설치하기: pip install 'markitdown[all]' 명령줄에서 파일을 Markdown으로 변환하기: markitdown path-to-file.pdf -o document.md
markitdown은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/microsoft/markitdown

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트