AIツール活用

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

中島大介(なかじ)読了時間 約21分
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を使う前に準備すること

MarkItDownは、ターミナル(Macの黒い画面)で使う道具です。最初に、使う画面と、変換するファイル、外に送られる情報の範囲を確かめておきましょう。準備することは、以下の3つです。

  1. ターミナルを開いて作業用のフォルダを決める
  2. 変換したいファイルを1つのフォルダに集める
  3. 外のサービスを使う機能を知っておく

ターミナルを開いて作業用のフォルダを決める

ターミナルは、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つです。

  1. 画像の説明文を作る機能
  2. 音声を文字にする機能
  3. MicrosoftのクラウドのAzure(Document Intelligence・Content Understanding)を使って読み取る機能

本記事の手順で入れる部品には、音声やAzureの部品は含めていません。外に送りたくない資料は、上の3つの機能を使わずに変換しましょう。

上の画像は、MarkItDownの公式ページです。右側の「MIT license」は、無料で使えるオープンソースのライセンスであることを示しています。

uvとMarkItDownをインストールする手順

MarkItDownはPythonで動く道具です。本記事では、Pythonの道具をまとめて管理できる「uv」を使って入れます。uvとMarkItDownをインストールする手順は、以下の4つです。

  1. uvが入っているか確かめる
  2. uvが入っていなければ公式のコマンドで入れる
  3. MarkItDownを入れる
  4. 入った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つです。

  1. 変換するファイルのあるフォルダに移る
  2. 元のPDFの中身を確かめる
  3. 画面に変換の結果を表示する
  4. 変換の結果をファイルに保存する

変換するファイルのあるフォルダに移る

ターミナルで「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つです。

  1. Wordの議事録を変換する
  2. PowerPointのスライドを変換する
  3. 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. まとめて変換するコマンドを実行する
  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つです。

  1. 元の資料と変換の結果を見比べる
  2. AIに渡すファイルを選んで依頼する
  3. 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つです。

  1. markitdown[all]で入れると古い版が入る
  2. スキャンしたPDFは何も表示されない
  3. 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つです。

  1. uvを入れて「uv tool install 'markitdown[pdf,docx,pptx,xlsx]'」でMarkItDownを入れる
  2. 入れた後は「uv tool list」で版を確かめる([all]で入れると古い版が入ることがある)
  3. 「markitdown ファイル名 -o 保存する名前.md」で変換して保存する
  4. 変換の結果は、金額・日付・表の行の数を元の資料と見比べる
  5. スキャンしたPDFは文字が出ないので、OCRや画像を読めるAIを使う

まずは手元の資料を1つ選んで「markitdown ファイル名」で画面に表示するところから試してみてください。

参考リンク

この記事の監修者

中島大介(なかじ)

中島大介(なかじ)

株式会社メリル 代表取締役 / 記事監修

株式会社メリル代表取締役。SEO歴20年以上。最新AIやセキュリティについて発信するYouTube「ウェブ職TV」は登録者15万人以上。著書「ChatGPT & Copilotの教科書」は10万部突破!

プロフィールを見る

関連する記事

Cursorのプラグイン「pstack」の使い方を解説する記事のアイキャッチ
AIツール活用

pstackの使い方|Cursor・Claude Codeへの入れ方と頼み方

pstackを使ってみたい方は必見!この記事では、pstackの入れ方と/poteto-modeでの頼み方を解説します。実は、pstackで最初に覚えるコマンドは2つだけです。記事を読めば、AIに確かめさせながら作業を任せられます。

中島大介(なかじ)監修 / Touch AI編集部25 分で読めます
MetaのAIエージェント「Muse」の使い方を解説する記事のアイキャッチ
AIツール活用

Museの使い方|Meta Museの始め方・初期設定・料金を解説

Museを使い始めたい方は必見!この記事では、Meta Museの始め方・初期設定・料金を解説します。実は、Museとのやり取りをAIの学習に使う設定は最初からオンです。記事を読めば、任せる範囲を決めてから使い始められます。

中島大介(なかじ)監修 / Touch AI編集部26 分で読めます
Claude Codeで複数ファイルを一括置換する方法を解説する記事のアイキャッチ
AIツール活用

複数ファイルの文字列を一括置換するには?Claude Codeで残す語を指定

製品名の変更で複数のファイルを直したい方は必見!この記事では、Claude Codeで複数のファイルの文字を一括置換する手順を解説します。実は、残す語を決めてから置き換えられます。記事を読めば、コピーから元に戻す方法も分かります。

中島大介(なかじ)監修 / Touch AI編集部19 分で読めます

次のステップ

最新動向を学びに変える

話題のAIアップデートを、現役講師が背景と実務への影響まで解きほぐします。Touch AI の最新講座で、変化に追いつくための視点を得てください。

受講できる講座を見る