MarkItDownの使い方!PDFやExcelをMarkdownに変換する手順

社内の資料をAIに読ませて要約させたいのに、PDFやExcelのままだとうまく読み込めずに困った経験はないでしょうか。ファイルの形式がバラバラだと、AIに渡す前の準備だけで時間がかかってしまいます。
MarkItDownは、PDF・Word・Excel・PowerPointなどのファイルを、AIが読みやすい文字だけの形式(Markdown)に変換する無料の道具です。Microsoftが公開しており、ターミナルでコマンドを1行打つだけで変換できます。ただし、入れ方を間違えると古い版が入るなど、最初につまずきやすい点もあるので注意しましょう。
この記事では、MarkItDownをMacに入れる手順から、形式ごとの変換、まとめての変換、AIへの渡し方、うまく変換できないときの対処までを実画面で解説します。
この記事を読めば、手元の資料をMarkdownに変換して、AIに渡せる形にできるようになります。入れるコマンドは「uv tool install 'markitdown[pdf,docx,pptx,xlsx]'」の1行です。
目次
- MarkItDownを使う前に準備すること
- uvとMarkItDownをインストールする手順
- MarkItDownでPDFをMarkdownに変換する手順
- MarkItDownでWord・PowerPoint・Excelを変換する手順
- MarkItDownで複数のファイルをまとめて別のフォルダに変換する手順
- MarkItDownの変換結果を確かめてAIに渡す手順
- MarkItDownでうまく変換できないときの対処法
- MarkItDownの使い方に関するよくある質問
- まとめ
- 参考リンク
MarkItDownを使う前に準備すること
MarkItDownは、ターミナル(Macの黒い画面)で使う道具です。最初に、使う画面と、変換するファイル、外に送られる情報の範囲を確かめておきましょう。準備することは、以下の3つです。
- ターミナルを開いて作業用のフォルダを決める
- 変換したいファイルを1つのフォルダに集める
- 外のサービスを使う機能を知っておく
ターミナルを開いて作業用のフォルダを決める
ターミナルは、Finderの「アプリケーション」→「ユーティリティ」の中にある「ターミナル」というアプリです。Spotlight(command+スペース)で「ターミナル」と入力しても開けます。
MarkItDownは、ターミナルで開いているフォルダの中のファイルを変換します。本記事では、ホームフォルダの中に作った「touchai-demo/markitdown-demo/資料」というフォルダで作業しました。フォルダには「cd ~/touchai-demo/markitdown-demo/資料」と入力してEnterキーを押すと移れます。「~」はホームフォルダを表す記号です。
自分の資料のフォルダに移るときは、ターミナルに「cd」と半角の空白を1つ入力してから、Finderのフォルダをターミナルの画面にドラッグします。フォルダの場所が入力されるので、Enterキーを押してください。
変換したいファイルを1つのフォルダに集める
変換したいPDF・Word・Excel・PowerPointを、1つのフォルダにまとめておくと作業が楽になります。本記事では、架空の見積書・議事録・研修の案内・売上表と、紙をスキャンしたかわりの文字のないPDFを用意しました。
本記事の画面に出てくる会社名・人名・金額はすべて架空のものです。お客さまの名前や個人情報が入ったファイルで試す前に、会社のルールを確かめておきましょう。
外のサービスを使う機能を知っておく
MarkItDownのPDF・Word・Excel・PowerPointの変換は、手元のMacの中で行われます。一方で、MarkItDownの公式ページ(GitHub)には、外のサービスを使う機能も書かれています。外のサービスを使う機能は、以下の3つです。
- 画像の説明文を作る機能
- 音声を文字にする機能
- MicrosoftのクラウドのAzure(Document Intelligence・Content Understanding)を使って読み取る機能
本記事の手順で入れる部品には、音声やAzureの部品は含めていません。外に送りたくない資料は、上の3つの機能を使わずに変換しましょう。
上の画像は、MarkItDownの公式ページです。右側の「MIT license」は、無料で使えるオープンソースのライセンスであることを示しています。
uvとMarkItDownをインストールする手順
MarkItDownはPythonで動く道具です。本記事では、Pythonの道具をまとめて管理できる「uv」を使って入れます。uvとMarkItDownをインストールする手順は、以下の4つです。
- uvが入っているか確かめる
- uvが入っていなければ公式のコマンドで入れる
- MarkItDownを入れる
- 入ったMarkItDownの版を確かめる
uvが入っているか確かめる
ターミナルで「uv --version」と入力してEnterキーを押します。以下の画像のように「uv」と版の番号が表示されれば、uvは入っています。
「command not found: uv」と表示された場合は、uvが入っていません。次の手順で入れてください。
uvが入っていなければ公式のコマンドで入れる
uvは、uvの公式のインストールのページに書かれた1行のコマンドで入ります。ページの「macOS and Linux」のタブに表示されている、以下のコマンドをターミナルに貼り付けてEnterキーを押してください。
- curl -LsSf https://astral.sh/uv/install.sh | sh
撮影に使ったMacには、すでにuvが入っていたため、インストールの途中の画面は撮っていません。入れ終わったら、ターミナルを一度閉じて開き直し、前の手順の「uv --version」で確かめましょう。
MarkItDownを入れる
ターミナルで以下のコマンドを入力し、Enterキーを押します。PDF・Word・PowerPoint・Excelの変換に必要な部品をまとめて入れるコマンドです。
- uv tool install 'markitdown[pdf,docx,pptx,xlsx]'
最後に「Installed 1 executable: markitdown」と表示されれば、MarkItDownが入っています。撮影のMacでは、Pythonを別に用意しなくても、uvが管理するPythonの上にそのまま入りました。
公式ページには、Pythonの仮想環境を作ってpipで入れる手順が書かれています。本記事のuv tool installは、仮想環境を自分で作らずに1行で済む方法です。
入ったMarkItDownの版を確かめる
ターミナルで「uv tool list」と入力すると、uvで入れた道具と版が表示されます。以下の画像では「markitdown v0.1.9」と表示され、2026年11月8日時点の最新の版が入ったと分かりました。
「markitdown --version」と入力しても、版を確かめられます。初めて実行したときは、表示まで10秒ほどかかりました。
MarkItDownでPDFをMarkdownに変換する手順
最初に、文字の入ったPDFを変換してみましょう。MarkItDownでPDFを変換する手順は、以下の4つです。
- 変換するファイルのあるフォルダに移る
- 元のPDFの中身を確かめる
- 画面に変換の結果を表示する
- 変換の結果をファイルに保存する
変換するファイルのあるフォルダに移る
ターミナルで「cd ~/touchai-demo/markitdown-demo/資料」と入力して、ファイルのあるフォルダに移ります。「ls」と入力すると、フォルダの中のファイルが表示されます。
元のPDFの中身を確かめる
変換の前に、元のPDFを開いて中身を確かめておきます。後で変換の結果と見比べるためです。
画面に変換の結果を表示する
ターミナルで「markitdown 見積書.pdf」と入力してEnterキーを押します。「見積書.pdf」の部分は、自分のファイルの名前に置き換えてください。ファイル名に空白があるときは「markitdown "見積 書.pdf"」のように「"」で囲みます。
上の画像のように、PDFの文字が画面に表示されます。「|」で区切られた部分は、Markdownの表です。今回のPDFでは、品目の表が表の形のまま取り出せました。
変換の結果をファイルに保存する
変換の結果をファイルに残すには、ファイル名の後に「-o 保存するファイルの名前」を付けます。本記事では、以下のコマンドを実行しました。
- markitdown 見積書.pdf -o 見積書.md
保存が終わっても、画面には何も表示されません。「ls」でフォルダの中を見て「見積書.md」が増えていれば、保存は成功です。
ターミナルで「open .」と入力すると、今のフォルダがFinderで開きます。Finderで「見積書.md」を選んでスペースキーを押し、クイックルックで中身をのぞいてみましょう。
PDFの作り方によっては、表が崩れたり、文字の順番が入れ替わったりすることがあります。金額や日付は、元のPDFと必ず見比べましょう。
MarkItDownでWord・PowerPoint・Excelを変換する手順
Word・PowerPoint・Excelも、PDFと同じコマンドで変換できます。ファイルの形式ごとに、変換のされ方に特徴があります。形式ごとの変換の手順は、以下の3つです。
- Wordの議事録を変換する
- PowerPointのスライドを変換する
- Excelの表を変換する
Wordの議事録を変換する
以下の画像は、変換する前のWordの議事録を、Macのテキストエディットで開いた画面です。テキストエディットでは見出しの書式は再現されませんが、中身と表は確かめられます。
ターミナルで「markitdown 議事録.docx」と入力してEnterキーを押します。
Wordの見出しは「#」、箇条書きは「*」の付いた行に変わりました。表の1行目は見出しの行にならず、上に空の見出しの行が付いています。AIに渡すときに、表の1行目が項目名であることを一言添えると伝わりやすくなります。
PowerPointのスライドを変換する
PowerPointのファイルは、スライドごとに区切って変換されます。以下の画像は、変換する前の研修の案内のスライドです。
ターミナルで「markitdown 研修の案内.pptx」と入力してEnterキーを押します。
「Slide number: 1」のような行が、スライドの区切りです。スライドのタイトルは「#」の見出しに、スライドの中の表はMarkdownの表に変わりました。
Excelの表を変換する
Excelのファイルは、シートごとに見出しと表に変換されます。ターミナルで「markitdown 売上表.xlsx」と入力してEnterキーを押しましょう。
上の画像のように、シートの名前(10月・11月)が「##」の見出しになり、見出しの下に表が続きます。変換した後は、Excelで開いた元の表と、シートの数・行の数・数字を見比べてください。
撮影のMacにはExcelがなく、シートが2枚のファイルはクイックルックでも表示されなかったので、元のExcelの画面は載せていません。
MarkItDownで複数のファイルをまとめて別のフォルダに変換する手順
ファイルが多いときは、1つずつ変換するより、まとめて変換したほうが早く済みます。まとめて変換する手順は、以下の2つです。
- まとめて変換するコマンドを実行する
- できたファイルの大きさを確かめる
まとめて変換するコマンドを実行する
ファイルのあるフォルダで、以下の1行をそのままターミナルに貼り付けてEnterキーを押します。
- mkdir -p md && for f in *.(pdf|docx|pptx|xlsx)(N); do markitdown "$f" -o "md/$f.md"; done
上のコマンドは「mdというフォルダを作り、PDF・Word・PowerPoint・Excelのファイルを1つずつ変換して、mdのフォルダに保存する」という意味です。Macの標準のシェル(zsh)で動く書き方で、どれかの形式のファイルがなくても途中で止まりません。
保存するファイルの名前は「見積書.pdf.md」のように、元の拡張子を残します。「見積書.pdf」と「見積書.docx」のように名前が同じファイルがあっても、上書きされません。ファイル名に空白があっても「"$f"」と囲んであるので変換できます。
できたファイルの大きさを確かめる
変換が終わったら「ls md」でできたファイルの一覧を「wc -c md/*」でファイルの大きさ(バイト数)を確かめます。
上の画像では、5つのファイルが変換されました。ただし「請求書_スキャン.pdf.md」だけは大きさが0で、中身がありません。大きさが0のファイルは、文字を取り出せなかったファイルです。対処は後の「うまく変換できないとき」の見出しで解説します。
コマンドを打つのが不安な場合は、Claude Codeに「このフォルダのPDFとWordを全部markitdownでMarkdownにして、mdフォルダに保存して」と頼む方法もあります。
MarkItDownの変換結果を確かめてAIに渡す手順
変換したMarkdownは、ChatGPTやClaudeなどのチャットに貼り付けたり、Claude Codeに読ませたりできます。AIに渡す手順は、以下の3つです。
- 元の資料と変換の結果を見比べる
- AIに渡すファイルを選んで依頼する
- AIの答えを元の資料で確かめる
元の資料と変換の結果を見比べる
AIに渡す前に、変換の結果に抜けや崩れがないかを確かめます。特に、金額・日付・人の名前・表の行の数は、元の資料と1つずつ見比べてください。
AIに渡すファイルを選んで依頼する
本記事では、Claude Codeに2つのMarkdownを渡して、要点をまとめてもらいました。資料のフォルダでClaude Codeを起動し、入力欄に以下の依頼を入力しています。
- @md/見積書.pdf.md @md/議事録.docx.md この2つのファイルを読んで、見積の合計金額と有効期限、議事録の次回までの担当を、短い箇条書きでまとめてください
「@」の後にファイルの場所を書くと、書いたファイルをClaude Codeに渡せます。画像の黒い部分は、編集部の環境の情報(契約プラン名や利用枠の表示)を隠したものです。画面の下の「auto mode on」は、権限のモードがautoであることを示す表示です。
AIの答えを元の資料で確かめる
Claude Codeは、2つのファイルを読んで答えを返しました。
上の画像では、合計金額(233,200円)や担当と期限が、元の資料と一致していました。AIの答えも、最後は元の資料で確かめましょう。Claude Codeを終えるときは、入力欄に「/exit」と入力してEnterキーを押します。
Claude Codeの起動や基本の使い方は、使い方の記事で解説しています。
Claude Codeの使い方を解説!導入から日本語での依頼・変更確認まで
MarkItDownでうまく変換できないときの対処法
MarkItDownを使っていると、入れ方やファイルの種類によって、思ったとおりに動かないことがあります。撮影の中で実際に起きたつまずきと対処は、以下の3つです。
- markitdown[all]で入れると古い版が入る
- スキャンしたPDFは何も表示されない
- Macに最初から入っているPythonでは条件に合わない
markitdown[all]で入れると古い版が入る
公式ページには、すべての部品を入れる「markitdown[all]」という書き方が載っています。ところが、撮影の日(2026年11月8日)に「uv tool install 'markitdown[all]'」で入れると、エラーは出ずに入ったものの、版を確かめると0.1.5でした。
最新の0.1.9の[all]には、uvが最初の設定では選ばない試験版の部品が含まれていたため、uvが古い版に戻して入れたと考えられます。入れた後は「uv tool list」で版を確かめ、古い版が入っていたら、いったん消して必要な部品だけを指定して入れ直してください。消すコマンドは「uv tool uninstall markitdown」です。
スキャンしたPDFは何も表示されない
紙をスキャンしたPDFや、画面を写真のように保存したPDFは、文字の情報を持っていません。以下の画像のPDFは、見た目は請求書ですが、文字のない画像だけのPDFです。
「markitdown 請求書_スキャン.pdf」で変換しても、画面には何も表示されませんでした。
スキャンしたPDFは、文字を読み取る機能(OCR)のある道具で先に文字にするか、画像を読めるAIに直接渡しましょう。MarkItDownの公式ページには画像の文字を読む追加の部品(markitdown-ocr)も載っていますが、外のAIのサービスにつなぐ設定が要ります。
Macに最初から入っているPythonでは条件に合わない
MarkItDownは、Python 3.10から3.14で動く道具です。Macに最初から入っているpython3の版は、ターミナルで「/usr/bin/python3 --version」と入力すると確かめられます。
上の画像のように、撮影のMacに最初から入っていたpython3は3.9.6で、条件に合いませんでした。「pip install markitdown」がうまくいかないときは、本記事のようにuvで入れる方法を試してください。
MarkItDownの使い方に関するよくある質問
MarkItDownの使い方について、よくある質問と答えをまとめました。
MarkItDownは無料で使えますか?
MarkItDownは無料で使えるオープンソースの道具です。公式ページに、MITライセンスであることが示されています。ただし、Azureの読み取りや画像の説明文などの外のサービスにつなぐ機能は、つないだ先のサービスの料金がかかることがあります。
WindowsでもMarkItDownは使えますか?
MarkItDownはPythonで動くので、Windowsでも使えます。本記事はMacの画面で撮影しているため、Windowsの手順は撮っていません。Windowsでは、uvの公式のインストールのページの「Windows」のタブにあるコマンドでuvを入れてください。
MarkItDownをClaude CodeなどのAIから直接使えますか?
MarkItDownには、AIの道具から呼び出せるMCPサーバーの部品(markitdown-mcp)も公開されています。本記事では試していません。まずは本記事の手順で変換し、できたMarkdownを渡す方法から始めると、どこで問題が起きたかを確かめやすくなります。
MCPの仕組みと使い方は、MCPの記事で解説しています。
Claude CodeのMCPとは?設定方法と接続できないときの対処法を解説
まとめ
MarkItDownは、PDF・Word・Excel・PowerPointのファイルを、AIに渡しやすいMarkdownに変換できる無料の道具です。MarkItDownの使い方の要点は、以下の5つです。
- uvを入れて「uv tool install 'markitdown[pdf,docx,pptx,xlsx]'」でMarkItDownを入れる
- 入れた後は「uv tool list」で版を確かめる([all]で入れると古い版が入ることがある)
- 「markitdown ファイル名 -o 保存する名前.md」で変換して保存する
- 変換の結果は、金額・日付・表の行の数を元の資料と見比べる
- スキャンしたPDFは文字が出ないので、OCRや画像を読めるAIを使う
まずは手元の資料を1つ選んで「markitdown ファイル名」で画面に表示するところから試してみてください。



