PDF、Word、PowerPointを一気にMarkdown変換！AIとの連携がスムーズになるファイル変換ツール — markitdown

アーキテクチャ・仕組み

• Pythonの軽量ユーティリティとして設計されており、ファイルの種類ごとに DocumentConverter クラスが用意されている
• v0.1.0以降、ファイルパスではなくバイナリストリーム（io.BytesIO等）から読み込む設計に変更され、一時ファイルの作成が不要になった
• プラグインシステムにより、サードパーティが独自の変換器を追加可能（#markitdown-plugin タグで公開）

対応ファイル形式

LLM連携機能

• OpenAI互換のクライアントを渡すことで、画像の説明文生成（GPT-4o等）や音声の文字起こしが可能
• llm_client、llm_model、llm_prompt（カスタムプロンプト）を設定できる
• markitdown-ocr プラグインを使えば、PDF・DOCX・PPTX・XLSX内の埋め込み画像からもOCRでテキスト抽出可能

Azure Document Intelligence連携

• MicrosoftのAzure Document Intelligenceサービスを使った高精度な文書変換に対応
• コマンドライン: markitdown file.pdf -d -e "<endpoint>"
• Python API: MarkItDown(docintel_endpoint="<endpoint>")

MCP（Model Context Protocol）サーバー

• markitdown-mcp パッケージとして提供され、Claude Desktopなどの LLM アプリケーションとの統合が可能

実行環境

• Python: 3.10以上が必須
• Docker: Dockerfile同梱、docker build -t markitdown:latest . でコンテナ化可能
• Devcontainer: VS Code Devcontainer対応、すべての依存関係がプリインストール済み

オプション依存の管理

# 全部入り
pip install 'markitdown[all]'

# 必要な形式だけ選んでインストール
pip install 'markitdown[pdf, docx, pptx]'

破壊的変更（v0.0.1 → v0.1.0）

• 依存関係がオプショナルなグループに整理された
• convert_stream() はバイナリファイルオブジェクトのみ受け付けるようになった（io.StringIOは非対応）
• DocumentConverter のインターフェースがファイルパスからストリームベースに変更

テスト・開発

• hatch を使用したテスト実行: hatch shell → hatch test
• pre-commit によるコード品質チェック

ライセンス・商用利用

• Microsoftが開発・公開しているOSSプロジェクト
• コントリビューション時はCLA（貢献者ライセンス契約）への同意が必要
• Microsoft Open Source Code of Conduct を採用

# Python 3.10以上が必要。仮想環境の作成を推奨
python -m venv .venv
source .venv/bin/activate

# 全機能をインストール
pip install 'markitdown[all]'

# 基本的な使い方（コマンドライン）
markitdown path-to-file.pdf > document.md

# 出力ファイルを指定する場合
markitdown path-to-file.pdf -o document.md

# Pythonコードから使う場合

from markitdown import MarkItDown

md = MarkItDown()
result = md.convert("test.xlsx")
print(result.text_content)