markitdown

MarkItDown - ファイルから Markdown への変換ツール

ファイルを Markdown に変換します：$ARGUMENTS

前提条件

markitdown CLI がインストールされている必要があります。見つからない場合は、インストールします：

# Preferred (fastest, no conflicts)
uv tool install 'markitdown[all]'

# Alternatives
pipx install 'markitdown[all]'
pip install --user 'markitdown[all]'

対応形式

形式	拡張子	備考
PDF	.pdf	レイアウトを保持してテキストを抽出します
Word	.docx	見出し、表、リストを保持します
PowerPoint	.pptx	スライドごとにヘッダー付きで変換します
Excel	.xlsx、.xls	シートごとの表に変換します
HTML	.html、.htm	全体の構造を変換します
CSV	.csv	Markdown の表に変換します
JSON	.json	書式を整えて出力します
XML	.xml	書式を整えて出力します
画像	.jpg、.png、.gif、.webp	EXIF メタデータを抽出します
音声	.mp3、.wav	文字起こし（ffmpeg が必要です）
メール	.msg	Outlook メッセージを抽出します
電子書籍	.epub	全文を抽出します
アーカイブ	.zip	内容を一覧表示し、内部の対応ファイルを変換します
URL	http://...	Web ページを取得して変換します

ワークフロー

ステップ 1：引数を解析する

$ARGUMENTS を解析し、次を特定します：

• 対象：ファイルパス、glob パターン、ディレクトリ、または URL
• 出力オプション：ファイルに保存するには -o output.md を指定します。指定しない場合は標準出力に表示します
• バッチモード：対象がディレクトリまたは glob パターンの場合に使用します

引数が指定されていない場合は、変換するファイルをユーザーに確認します。

ステップ 2：対象を検証する

# Check if file exists
ls -la "$TARGET"

# Check markitdown is available
markitdown --version

markitdown がインストールされていない場合は、次のコマンドでインストールします：

uv tool install 'markitdown[all]'

ステップ 3：変換する

単一ファイル：

markitdown "$FILE_PATH"

ファイルに保存する場合：

markitdown "$FILE_PATH" -o "$OUTPUT_PATH"

URL から変換する場合：

markitdown "$URL"

バッチ変換（ディレクトリ）：

for f in "$DIR"/*.{pdf,docx,pptx,xlsx,html,csv}; do
    [ -f "$f" ] && markitdown "$f" -o "${f%.*}.md"
done

拡張子を指定して標準入力から変換する場合：

cat "$FILE" | markitdown -x .html

ステップ 4：結果を提示する

• 出力が短い場合（200 行未満）：会話内に直接表示します
• 出力が長い場合：.md ファイルに保存し、パスを伝えます
• バッチ変換の場合：変換したファイルの概要を伝えます

ステップ 5：後処理（任意）

ユーザーから依頼があれば、次の処理を実行できます：

1. 要約する：変換後の Markdown を読み、要約を作成します
2. 特定の情報を抽出する：Markdown を解析し、表、見出し、重要なデータを抽出します
3. 整える：不要な要素を削除し、書式の問題を修正します
4. 翻訳する：Markdown はクリーンなテキストになっているため、翻訳できます
5. 分割する：大きな文書をセクションに分割します

例

/markitdown report.pdf
/markitdown slides.pptx -o slides.md
/markitdown data.xlsx
/markitdown https://example.com/page.html
/markitdown ./documents/              # batch convert all supported files
/markitdown *.pdf                     # convert all PDFs in current directory

エラー処理

エラー	解決方法
markitdown: command not found	次を実行します：uv tool install 'markitdown[all]'
No such file or directory	ls でファイルパスを確認します
音声の文字起こしに失敗する	ffmpeg をインストールします：brew install ffmpeg（macOS）または apt install ffmpeg（Linux）
PDF から何も抽出されない	PDF が画像のみの可能性があります。OCR ツールの使用を提案します
エンコーディングの問題	次を試します：markitdown -c UTF-8 "$FILE"