Pandocのインストールで確かめるべきは成功表示ではなく、どのpandocが呼ばれているか

インストール完了の表示は、どこかに入ったことの証明であって、あなたがいま打つコマンドがそれを使うことの証明ではありません。入れたはずなのに動かない、新しい機能が使えない、という事態が起きるのは、手順の誤りより、どの版がどこに入り、どれが呼ばれているかの食い違いが原因であることが多いからです。この記事では、OSごとの手順に加えて、入れる前に決める条件と、入った後に確かめる二つの点を整理します。

入れる前に、自分の環境の条件を三つ決めます

Pandocは、Markdown、HTML、LaTeX、Word、PDFなどを互いに変換するコマンドラインのツールで、Windows、macOS、主要なLinuxで動きます。基本の変換だけなら、ほかのソフトは要りません。

手順を選ぶ前に、次の三つを決めておきます。どのOSか。HomebrewやChocolateyのようなパッケージ管理ツールを使うか。管理者の権限があるか。会社のパソコンで権限がないのに管理者向けの手順を読み進めるのは、鍵を持たずに玄関の開け方の説明書を熟読するようなものです。条件が違えば正しい手順も違うので、手順の正しさは条件を決めた後でしか判断できません。

OSごとの手順は、入れ方によって入る場所が変わります

Windows

Pandoc公式のダウンロードページから、Windows用のインストーラー（.msiファイル）を入手して実行します。インストール先は初期設定のままでかまいません。インストーラーは通常、環境変数PATHにPandocの場所を自動で加えます。Chocolateyを使っている場合は、管理者としてコマンドプロンプトを開き、次の一行でも入れられます。

choco install pandoc

macOS

Homebrewを使うのが手軽です。入っていなければHomebrew公式サイトの案内で先に入れておき、ターミナルで次を実行します。使わない場合は、公式のダウンロードページからmacOS用のインストーラー（.pkgファイル）を入手します。

brew install pandoc

Linux

多くのディストリビューションでは、標準のパッケージ管理ツールで入れられます。

sudo apt update
sudo apt install pandoc        # Ubuntu、Debian系
sudo dnf install pandoc        # Fedora
sudo pacman -S pandoc          # Arch Linux

ただし、標準のリポジトリには最新版が入っていないことがあります。新しい版が必要なら、公式のダウンロードページから.debや.rpmのパッケージ、または.tar.gzの圧縮ファイルを入手します。.debなら sudo dpkg でファイル名を指定して入れます。Haskellのビルドツールstackでソースから入れる方法もあり、その場合Pandocは ~/.local/bin に入るので、この場所をPATHに加えます。

ここで気づいてほしいのは、入れ方ごとに置き場所が違うことです。標準のリポジトリで古い版を入れた後に、公式の新しい版やstackの版を足すと、同じ名前のpandocが二つ以上ある状態になります。どれが呼ばれるかは、PATHに並んだ順番で決まります。

確かめるのは、版の番号と、呼ばれている場所の二つです

多くの手順書は、版の番号が出れば成功、で終わります。番号が出たことは、どこかのpandocが動いたことしか意味しません。入れたばかりのものかどうかは分からないのです。そこで、版と場所を両方確かめます。

pandoc -v                 # 版の番号
which pandoc              # macOS、Linuxで呼ばれている場所
where.exe pandoc          # Windowsで呼ばれている場所（候補を順に表示）

場所が入れた場所と違う、あるいは候補が複数出るなら、古いほうを消すか、PATHの順番を直します。Windowsでは、インストール直後に開いていたコマンドプロンプトはPATHの変更を読み直していないことがあるので、いったん閉じて開き直してから確かめます。

最後に実際に変換します。行頭に # を付けた見出しと短い文章を書いた test.md を作り、HTMLにして、ブラウザで見出しと文章が正しく出れば準備は完了です。

pandoc test.md -o test.html

この二段の確認がいらない場面もあります。まっさらなパソコンに、一つの方法で一度だけ入れたのなら、呼ばれるpandocは一つしかありえず、版の番号だけで十分です。場所の確認が効いてくるのは、入れ直しや追加を重ねた環境です。

PDFは別の道具の仕事です

PandocでPDFを作るには、LaTeXの環境が別に要ります。どのOSでも使えるTeX Live、主にWindows向けのMiKTeX、macOS向けのMacTeXが代表です。TeX Liveはネットインストーラーで、すべてのパッケージも、必要なものだけも選べます。入れた後は pdflatex の版の番号が表示できるかで確かめます。PDFが作れないとき、疑うべきはPandocより先にこちらです。

うまく動かないときは、PATHの設定、足りないソフト、版の古さ、エラーの文の順に確かめ、エラーの文は公式ドキュメントやGitHubのIssues、Stack Overflowで同じ事例を探します。更新は入れたときと同じ方法で行います。入れたときと違う方法で更新すると、二つ目のpandocが増えるだけです。

choco upgrade pandoc
brew update && brew upgrade pandoc
sudo apt update && sudo apt upgrade pandoc

AIに手順を聞くときは、条件を先に渡します

ChatGPTなどのAIに手順を聞くのは有効です。ただし、前提を渡されないAIは、手持ちの知識で空白を埋めます。OSも権限も伝えずに聞けば、いちばんよくある環境を想定した、あなたの環境では動かないかもしれない手順が、迷いのない文体で返ってきます。最初に決めた三つの条件を、そのまま渡します。

あなたはパソコンの設定に詳しいサポート担当です。私の環境は macOS で、Homebrew は入っていません。管理者の権限はあります。Pandoc を入れて、Markdown を Word に変換できるところまでの手順を、番号付きで教えてください。最後に、どの pandoc が呼ばれているかを確かめる方法も含めてください。途中でエラーが出たら、その文を貼るので原因を説明してください。

あなたのパソコンには、いまpandocがいくつ入っているでしょうか。それを入れたときの方法を、いま思い出せるでしょうか。

この記事の背景にある考え方は、拙著『ChatGPT はじめてのプロンプトエンジニアリング』の2章1節「プロンプトの重要性と設計方針」の、明確化と具体化の話に書きました。虫眼鏡で光を集めるように言葉の焦点を絞り、作業の内容と目的を過不足なく書き、固有名詞、数値、条件を加える、という話です。指示があいまいなままAIに頼むことを、そこでは「これは、目的地を告げずにタクシーに乗るようなものです。」とたとえています。この節を読むと、手順を聞く前に、OS、権限、入れ方のどれを告げていなかったかを、自分で洗い出せるようになります。

出典

• Installing pandoc
• Pandoc User's Guide
• Homebrew
• TeX Live
• jgm/pandoc（GitHub）