AIツール活用

Pandocの使い方|MarkdownをWordと日本語のPDFに変換する手順

中島大介(なかじ)読了時間 約19分
PandocでMarkdownをWordとPDFに変換する方法を解説する記事のアイキャッチ

ChatGPTやClaude Codeで社内のお知らせや報告書の下書きを作ると、見出しや箇条書きの入ったMarkdownの形で返ってくることがよくあります。ところが、社内の提出や取引先への送付ではWordやPDFを求められ、書式を手で整え直すことになりがちです。

「Pandoc」を使えば、Markdownの文書を、見出しや表を保ったままWordやPDFに変換できます。ただし、PDFの書き出しには別の道具が必要で、日本語の書体の指定を忘れると表が崩れることもあるため、手順を知っておくことが大切です。

この記事では、MacにPandocを入れる手順から、MarkdownをWordとPDFに変換する方法、Claude Codeに原稿の直しと変換をまとめて頼む方法までを実画面で解説します。

この記事を読めば、AIで書いたMarkdownの文書を、1行のコマンドでWordとPDFにできるようになります。PDFは「Typst」という道具と日本語の書体の指定を組み合わせるのが、崩れずに変換する近道です。

目次

Pandocで変換する前に原稿と完成形を確かめる

Pandocは、文書の形式を別の形式に変換する無料の道具です。MarkdownからWordへの変換では、Markdownの「#」の見出しはWordの「見出し1」のスタイルになります。「##」の見出しは「見出し2」のスタイルになり、箇条書きと表もWordの箇条書きと表になります。

Pandocで変換する前に知っておきたい点は、以下の4つです。

  • Wordへの変換は、Pandocだけでできる
  • PDFへの変換には、Pandocとは別の道具(この記事ではTypst)が要る
  • 変換にWordのアプリは要らない
  • 見た目の細かい調整は、変換した後のWordで行う

Markdownからスライドを作るならMarp、反対にWordやPDFをMarkdownにしてAIに読ませるならMarkItDownが向いています。

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

この記事では、架空の会社の「年末年始の業務のお知らせ」を練習用の原稿にします。見出し・箇条書き・表の3つが入った、社内のお知らせによくある形です。

HomebrewでPandocをインストールする手順

MacにPandocを入れるには、Macのアプリを入れる道具「Homebrew」を使います。HomebrewでPandocをインストールする手順は、以下の3つです。

  1. 作業フォルダを作ってHomebrewがあるかを確かめる
  2. brew install pandocでPandocを入れる
  3. pandoc --versionで版を確かめる

作業フォルダを作ってHomebrewがあるかを確かめる

Macのターミナルを開きます。ターミナルの場所は、Finderの「アプリケーション」→「ユーティリティ」の中です。

ターミナルに「mkdir -p ~/touchai-demo/pandoc-demo」と入力してEnterキーを押し、続けて「cd ~/touchai-demo/pandoc-demo」と入力してEnterキーを押したら、次に「brew --version」と入力してEnterキーを押します。

上の画像のように「Homebrew」と版の数字が表示されれば、Homebrewは入っています。「command not found」と表示された場合は、Homebrewの公式サイトの「インストール」の1行をターミナルに貼り付けて、先にHomebrewを入れてください。

brew install pandocでPandocを入れる

ターミナルに「brew install pandoc」と入力してEnterキーを押します。

上の画像の最後の行に「pandoc/3.13」とあれば、インストールは完了です。撮影では、Homebrewが先に自分の更新を確かめたため、新しく使えるようになった道具の一覧などがたくさん表示されました。

pandoc --versionで版を確かめる

「pandoc --version」と入力してEnterキーを押すと、入ったPandocの版が表示されます。

撮影時の版は3.13です。新しく入れると、版の数字が違うことがあります。

MarkdownをWordに変換する手順

Pandocが入ったら、練習用の原稿をWordに変換します。MarkdownをWordに変換する手順は、以下の3つです。

  1. 練習用の原稿をreport.mdに保存する
  2. pandoc report.md -o report.docxで変換する
  3. できたWordのファイルを開いて確かめる

練習用の原稿をreport.mdに保存する

下の1行のコマンドを、先頭の「printf」から最後の「report.md」まで選んでコピーし、ターミナルに貼り付けてEnterキーを押します。

printf '%s\n' '# 年末年始の業務のお知らせ' '' '総務部より、年末年始の業務の予定をお知らせします。' '' '## 休業日' '' '- 12月29日(火)から1月4日(月)まで休業します' '- 1月5日(火)から通常どおり営業します' '' '## 年内の締め切り' '' '| 書類 | 提出先 | 締め切り |' '| --- | --- | --- |' '| 経費精算 | 経理課 | 12月18日(金) |' '| 有給休暇の申請 | 所属の課長 | 12月11日(金) |' '| 年末調整の書類 | 総務部 | 12月4日(金) |' '' '## 休業中の連絡' '' '休業中の急ぎの連絡は、各課の当番にメールで連絡してください。' > report.md

続けて「cat report.md」と入力してEnterキーを押すと、保存した原稿が表示されます。

上の画像の原稿で使っている書き方は、以下の3つです。

  • 「#」で始まる行は見出し
  • 「-」で始まる行は箇条書き
  • 「|」で区切った行は表

自分の文書を変換するときは、AIが書いたMarkdownを、見出し・箇条書き・表の書き方のまま「.md」の名前のファイルに保存します。

pandoc report.md -o report.docxで変換する

ターミナルに「pandoc report.md -o report.docx」と入力してEnterキーを押します。「-o」の後ろに書いた名前と拡張子で、変換した後のファイルの形式が決まります。

何も表示されずに次の行の頭が出れば、変換は成功です。「ls」と入力すると、report.docxができていることを確かめられます。

できたWordのファイルを開いて確かめる

Finderでreport.docxをダブルクリックすると、Wordが入っているMacではWordで開きます。撮影したMacにはWordが入っていないため、ターミナルで「open -a TextEdit report.docx」と入力して、テキストエディットで開きました。

上の画像では、箇条書きと表が保たれています。テキストエディットでは、見出しの大きさは再現されません。ファイルの中を調べると、見出しにはWordの「見出し1」「見出し2」のスタイルが付いていました。Finderでreport.docxを選んでスペースキーを押すクイックルックでは、撮影したMacでは中身が表示されませんでした。

Typstで日本語のPDFに変換する手順

PDFへの変換には、Pandocのほかに、PDFを作る道具が必要です。Typstで日本語のPDFに変換する手順は、以下の3つです。

  1. HomebrewでTypstを入れる
  2. Typstを指定してPDFに変換する
  3. 日本語の書体と用紙の大きさを指定して変換し直す

HomebrewでTypstを入れる

PDFを作る道具を指定しないで「pandoc report.md -o report.pdf」と入力すると、撮影したMacではエラーが表示されました。

上の画像の「'pdflatex' not found」は、Pandocが最初に使う道具の「pdflatex」が見つからない、という意味です。撮影したMacにはpdflatexが入っていませんでした。pdflatexは入れる量が大きいため、この記事では軽い「Typst」を使います。

ターミナルに「brew install typst」と入力してEnterキーを押します。

撮影時に入ったTypstの版は0.15.1です。

Typstを指定してPDFに変換する

ターミナルに「pandoc report.md -o report.pdf --pdf-engine=typst」と入力してEnterキーを押します。「--pdf-engine=typst」は、PDFを作る道具にTypstを使う指定です。

Finderでreport.pdfを選んでスペースキーを押すと、クイックルックで中身が開きます。

上の画像の表は、行の高さがずれて読みにくくなっています。編集部が調べると、PDFの中では日本語に2つの別々の書体が使われていました。用紙の大きさも、撮影の時点ではA4ではなくアメリカで使われるレターの大きさでした。

日本語の書体と用紙の大きさを指定して変換し直す

ターミナルに、下のコマンドを入力してEnterキーを押します。

pandoc report.md -o report.pdf --pdf-engine=typst -V mainfont="Hiragino Sans" -V papersize=a4

「-V mainfont="Hiragino Sans"」は、Macに入っている日本語の書体(ヒラギノ角ゴシック)を使う指定です。用紙をA4にするのが「-V papersize=a4」の指定です。

上の画像では、表の3行がそろい、見出しも太字で読みやすくなりました。撮影したMacでは、書体と用紙を指定すると表の行のずれがなくなりました。

Claude Codeに原稿の直しと変換をまとめて頼む手順

原稿を直すたびに長いコマンドを打つのは手間です。Claude Codeに原稿の直しと変換を頼み、変換のコマンドをファイルに残してもらえば、次からは短い1行で変換できます。Claude Codeはインストールとログインが済んでいる前提です。

Claude Codeに原稿の直しと変換をまとめて頼む手順は、以下の3つです。

  1. 確認してから進めるモードでClaude Codeを起動する
  2. 直す内容と変換の条件を書いて頼む
  3. 残してもらったconvert.shで変換し直す

確認してから進めるモードでClaude Codeを起動する

pandoc-demoのフォルダで「claude --permission-mode manual --model sonnet」と入力してEnterキーを押します。「--permission-mode manual」は、ファイルの変更やコマンドの実行の前に、原則として許可を求めるモードの指定です。「--model sonnet」は撮影で使ったモデルの指定で、付けなくてもかまいません。

上の画像の画面で「Yes, I trust this folder」を選んでEnterキーを押します。黒い部分は、撮影したパソコンのユーザー名を隠したものです。撮影では、いつも使っている設定を読み込まない状態でClaude Codeを起動しました。

直す内容と変換の条件を書いて頼む

入力した文の全文は、以下のとおりです。

「report.md の「休業日」の箇条書きの最後に「12月28日(月)は午後3時で業務を終えます」を足してください。そのあと、Pandoc で report.docx と report.pdf に変換し直してください。変換のコマンドは、次から1行で使えるように convert.sh に保存してください。PDF は Typst を使い、書体は Hiragino Sans、用紙は A4 にします。」

Claude Codeは最初に、原稿の中身とPandocとTypstの版を確かめるコマンドの実行を求めました。

上の画像の「Tip: auto mode handles these prompts for you」は、autoのモードにすると確認をAIが代わりに判断するという案内です。選択肢の2つ目は同じコマンドを次から聞かずに実行する指定、3つ目はautoのモードに切り替える指定なので、練習では「1. Yes」を選びます。

続けて、原稿を直す前に、変える行を表示して許可を求めます。

上の画像の緑の行が、足される1行です。

「1. Yes」を選ぶと、Claude Codeは続けてconvert.shを作ってよいかを聞きます。

convert.shの作成も「1. Yes」で許可すると、最後に変換を動かすコマンドの実行を求めます。

上の画像の最後のコマンドで続けて動かすものは、以下の4つです。

  • convert.shを動かせるようにする「chmod +x convert.sh」
  • 変換を動かす「./convert.sh」
  • できたファイルの一覧を出す「ls -l」
  • PDFに使われた書体を調べる「pdffonts」

pdffontsは、Macに最初から入っているとは限らないコマンドです。

中身を確かめてから「1. Yes」を選びます。

残してもらったconvert.shで変換し直す

上の画像の報告には「用紙サイズ(A4)は確認していません」とあります。編集部が別のコマンドで確かめると、PDFの用紙はA4の大きさでした。

入力欄に「/exit」と入力してEnterキーを押し、Claude Codeを終えます(撮影では、終える画面は撮っていません)。ターミナルで「./convert.sh」と入力してEnterキーを押すと、WordとPDFが作り直されます。

上の画像の「cat convert.sh」は、convert.shの中身を表示したものです。

convert.shの中身は、1行目の「#!/bin/sh」と、2行目の「cd "$(dirname "$0")" && pandoc report.md -o report.docx && pandoc report.md -o report.pdf --pdf-engine=typst -V mainfont="Hiragino Sans" -V papersize=a4」の2行です。自分で同じ内容のファイルを作ったときは「sh convert.sh」と入力すれば動かせます。

Pandocの変換で困ったときの確認事項

Pandocの変換で困ったときは、表示された文と、どの形式に変換したかを確かめます。撮影の中で起きたことと対処は、以下のとおりです。

起きたこと原因対処
'pdflatex' not foundと表示される最初に使う道具のpdflatexが入っていない--pdf-engine=typstを付ける(Typstを入れておく)
PDFの表の行がずれる日本語の書体を指定していない(撮影したMacの場合)-V mainfont="Hiragino Sans"を付ける
PDFがA4にならない用紙の大きさを指定していない-V papersize=a4を付ける
クイックルックでWordのファイルが白いクイックルックで中身が出ないWordかテキストエディットでWordのファイルを開く

Markdownの原稿では、空の行をはさまずに続けて書いた2行は、変換すると1つの段落につながります。段落を分けたい所には、原稿に空の行を入れてください。

Pandocの使い方に関するよくある質問

Pandocの使い方について、よくある質問と答えをまとめました。

Pandocは無料で使えますか?

Pandocは、GPL(バージョン2以降)のライセンスで公開されている無料の道具です。Typstも、Apache 2.0のライセンスで公開されています。

WindowsでもPandocを使えますか?

Pandocには、Windows向けのインストーラーもあります。入れ方はPandocの公式のインストールのページで確かめてください。この記事の画面とコマンドは、Macで確かめたものです。

会社のWordのひな形の書式に合わせられますか?

Pandocには、書式の見本にするWordのファイルを指定する「--reference-doc」があります。「pandoc -o custom-reference.docx --print-default-data-file reference.docx」で見本のファイルを作り、Wordで見出しや本文のスタイルを直して保存し、変換のときに「--reference-doc=custom-reference.docx」を付けます。撮影したMacにはWordがないため、編集部はこの方法を試していません。

WordのファイルをMarkdownに変換できますか?

Pandocは、WordのファイルをMarkdownに変換することもできます。PDFやExcelも含めてMarkdownにしたい場合は、MarkItDownの使い方の記事を参考にしてください。

まとめ

Pandocを使えば、AIで書いたMarkdownの文書を、見出し・箇条書き・表を保ったままWordやPDFに変換できます。Pandocの使い方の要点は、以下の5つです。

  1. 「brew install pandoc」でPandocを入れる
  2. 「pandoc report.md -o report.docx」でWordに変換する
  3. PDFは「brew install typst」でTypstを入れて、--pdf-engine=typstを付ける
  4. 日本語のPDFは、書体(Hiragino Sans)と用紙(A4)を指定する
  5. 原稿の直しと変換はClaude Codeに頼み、変換のコマンドをファイルに残す

まずは練習用の原稿を保存して、Wordに変換するところから試してみてください。

参考リンク

この記事の監修者

中島大介(なかじ)

中島大介(なかじ)

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

株式会社メリル代表取締役。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 の最新講座で、変化に追いつくための視点を得てください。

受講できる講座を見る