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で変換する前に原稿と完成形を確かめる
- HomebrewでPandocをインストールする手順
- MarkdownをWordに変換する手順
- Typstで日本語のPDFに変換する手順
- Claude Codeに原稿の直しと変換をまとめて頼む手順
- Pandocの変換で困ったときの確認事項
- Pandocの使い方に関するよくある質問
- まとめ
- 参考リンク
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つです。
- 作業フォルダを作ってHomebrewがあるかを確かめる
- brew install pandocでPandocを入れる
- 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つです。
- 練習用の原稿をreport.mdに保存する
- pandoc report.md -o report.docxで変換する
- できた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つです。
- HomebrewでTypstを入れる
- Typstを指定してPDFに変換する
- 日本語の書体と用紙の大きさを指定して変換し直す
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つです。
- 確認してから進めるモードでClaude Codeを起動する
- 直す内容と変換の条件を書いて頼む
- 残してもらった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つです。
- 「brew install pandoc」でPandocを入れる
- 「pandoc report.md -o report.docx」でWordに変換する
- PDFは「brew install typst」でTypstを入れて、--pdf-engine=typstを付ける
- 日本語のPDFは、書体(Hiragino Sans)と用紙(A4)を指定する
- 原稿の直しと変換はClaude Codeに頼み、変換のコマンドをファイルに残す
まずは練習用の原稿を保存して、Wordに変換するところから試してみてください。



