markitdown について
markitdownは、ローカル文書をMarkdownに変換するコマンドラインツールです。文書内容の抽出や整理に使え、PDFやOfficeファイル、画像OCR、音声の文字起こし、各種テキスト形式を1つのCLIで扱えます。
主な機能
- 01PDF、Word、Excel、PowerPointの変換
- 02画像からのOCRテキスト抽出
- 03音声のテキスト化
- 04HTML、テキスト、構造化データの変換
- 05CLIによるMarkdown出力
活用シーン
- 01PDFレポートをMarkdownに変換
- 02画像内の文字を抽出
- 03音声ファイルを文字起こし
- 04表計算ファイルやスライドをMarkdownとして整理
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ 0xdarkmatter/ claude-mods --skill markitdownインストール後、Claude Code で/markitdownを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
assets/.gitkeepreferences/.gitkeepscripts/.gitkeep詳細
markitdown - ドキュメントから Markdown へ
ローカルのドキュメントを読みやすい Markdown に変換します。PDF、Word、Excel、PowerPoint、画像などに対応するツールです。
markitdown を使う場面
| ユースケース | 推奨 |
|---|---|
| ローカルファイル(PDF、Word、Excel) | ✅ markitdown を使用 - 独自の機能です |
| Web ページ | ❌ Jina(r.jina.ai/)を使用 - 5 倍高速です |
| ブロックされているサイト/ボット対策のあるサイト | ❌ Firecrawl を使用 |
| 画像の OCR | ✅ markitdown を使用 |
| 音声の文字起こし | ✅ markitdown を使用 |
基本的な使い方
# Local files (primary use case)
markitdown document.pdf
markitdown report.docx
markitdown data.xlsx
markitdown slides.pptx
markitdown screenshot.png # OCR
# URLs (works, but Jina is faster)
markitdown https://example.com
# Save output
markitdown document.pdf > document.md
対応フォーマット
| フォーマット | 拡張子 | 備考 |
|---|---|---|
.pdf | テキスト抽出、表 | |
| Word | .docx | 書式を保持します |
| Excel | .xlsx | 表を Markdown に変換します |
| PowerPoint | .pptx | スライドをセクションとして扱います |
| 画像 | .jpg、.png | OCR によるテキスト抽出 |
| HTML | .html | 整形して変換します |
| 音声 | .mp3、.wav | 音声からテキストへ変換します |
| テキスト | .txt、.csv、.json、.xml | そのまま処理/構造を保持 |
| URL | https://... | 動作しますが、Jina より遅くなります |
ベンチマーク結果(URL)
| ツール | 平均速度 | 成功率 |
|---|---|---|
| Jina | 0.5s | 10/10 |
| markitdown | 2.5s | 9/10 |
| Firecrawl | 4.5s | 10/10 |
結論:URL には Jina を使用してください。ローカルファイルには markitdown が唯一の選択肢です。
使用例
# PDF to markdown (primary use case)
markitdown report.pdf > report.md
# Excel spreadsheet
markitdown financials.xlsx
# Image with text (OCR)
markitdown screenshot.png
# PowerPoint deck
markitdown presentation.pptx > slides.md
# Audio transcription
markitdown meeting.mp3 > transcript.md
代替ツールとの比較
| タスク | markitdown | 代替ツール |
|---|---|---|
| PDF テキスト | markitdown file.pdf | PyMuPDF、pdfplumber |
| Word ドキュメント | markitdown file.docx | python-docx |
| Excel | markitdown file.xlsx | pandas、openpyxl |
| OCR | markitdown image.png | Tesseract |
| Web ページ | 代わりに Jina を使用 | r.jina.ai/URL(5 倍高速) |
markitdown の利点:ローカルのすべてのドキュメント形式に対応する単一の CLI です。コードは必要ありません。
コメント
Markdown 対応