コンテンツへスキップ

← 記事一覧に戻る

Pandoc の代替:インストールできないとき、何を使えばいいのか

Pandoc はドキュメント形式変換の事実上の標準ツールです——しかしコマンドラインプログラムであり、その一点だけで多くの人は使えません。インストール権限のない社用 PC、借り物のマシン、あるいは一度きりの変換のためにツールチェーンを整えるのは割に合わない。「Pandoc の代替」を検索する人は、ほぼ例外なくこの具体的なつまずきに突き当たっており、変換品質への不満ではありません。

この記事では、本物の代替手段——オンライン変換ツール、mammoth、Turndown、スクリプトラッパー——と、見落とされがちなもう一つの選択肢を順に見ていきます。それは、Pandoc エンジン全体を WebAssembly にコンパイルし、ブラウザのタブ内で動かすというもの。CLI と同じ reader と writer を使いながら、インストールもアップロードも不要です。以下では、どの選択肢も同じ 3 つの基準で評価します。形式の対応範囲、出力品質、そしてあなたのファイルがたどる道です。

なぜ人は Pandoc の代替を探すのか

動機はきわめて一貫しています。社用 PC は未署名の実行ファイルのインストールを拒む。1 つの文書を 1 回変換するだけなのに、Haskell 製バイナリをインストールし、コマンドラインオプションの語彙まで覚えるのは割に合わない。単にターミナルではなくドラッグ&ドロップで済ませたい人もいます——しかし、そのどれもが「より劣る変換結果」を望んでいるわけではありません。むしろ、表を崩し見出しを失う素朴な変換ツールに懲りたからこそ Pandoc を選んだのです。

したがって「良い Pandoc の代替」の誠実な定義は、次の 3 つが同時に成立することです。Pandoc の形式理解力(見出し・表・脚注・メタデータ)を保つこと、インストールの壁を取り除くこと、そして機密文書をサードパーティのサーバーにアップロードするといった新しい問題を持ち込まないこと。この 3 つのハードルをすべて越えられるツールはごくわずかです。

各代替手段の正体

多くの人が最初に目にするのはオンライン文書変換ツールです。Word、PDF、一部のオフィス形式は扱えますが、形式への理解は浅く——複雑な表、脚注、スタイルに基づく見出し階層はたいてい崩れます——しかも仕組みはアップロード型で、ファイルはまずあなたのマシンを離れます。公開済みのマーケティング PDF なら構いませんが、契約書・研究原稿・社内資料では実質的なコストです。

mammoth は .docx をきれいな HTML や Markdown に変換することに特化したライブラリで、Word 文書に対する出力品質は確かに良好です——ただし読み込める入力形式は 1 種類だけで、しかもライブラリなので、使うにはスクリプトを書くか、それを組み込んだツールを探す必要があります。Turndown はその鏡像です。HTML から Markdown へだけを担当し、その一点では極めて優秀、それ以外には沈黙しています。pypandoc のようなスクリプトラッパーは、厳密には代替ではありません——駆動しているのは本物の Pandoc バイナリで、インストールの問題はそのまま残ります。

こうして「Pandoc の広さを保ちつつターミナルを不要にするツール」という空白が残ります。それに最も近いのが、Pandoc 本体を別のランタイムで動かすという選択肢です。

見落とされがちな選択肢:同じエンジンをブラウザで

Pandoc は WebAssembly にコンパイルできます。再実装でもサブセットでもありません——あの Haskell コードベースそのものをクロスコンパイルし、ブラウザのタブ内で動かしています。このビルドを組み込んだサイトなら、CLI と同じ docx、odt、EPUB、LaTeX、RST、MediaWiki、DocBook、Org の reader を、同じ Markdown、HTML などの writer とともに使えます。変換品質は Pandoc の品質です。それが Pandoc だからです。

代償は質的なものではなく機械的なものです。50 MB 超のエンジンはサイトごとに 1 回ダウンロードすればよく(以後はキャッシュされます)、各変換は Web Worker 上で走るため、超大規模なバッチ処理はシェルのループほど快適ではありません。それでも、何もインストールせず、何もアップロードせず、モダンブラウザさえあればどんなマシンでも動きます——この検索に追い込んだ、権限のロックされたあの PC でも。

保てるものと、手放すもの

保てるもの:reader のフルセット(本サイトでは 14 種類の文書形式に加え、専用のレイアウト解析エンジンによる PDF、SheetJS による Excel)、パイプ表と脚注を含む GitHub Flavored Markdown 出力、さらには高度な機能——CSL スタイルによる引用処理と Lua フィルタは、仮想ファイルシステムを介してブラウザ版でも動作します。ドラッグ&ドロップ、貼り付け、バッチキュー、ZIP ダウンロードが操作面を補います。

手放すもの:シェルレベルの自動化(「このフォルダのファイルを全部変換する」類の作業では CLI が常に勝ちます)、LaTeX ツールチェーン経由の PDF 出力、そして Pandoc が持つ数十の追加 writer の裾野。ワークフローが定期実行スクリプトや静的サイトのビルドステップなら、CLI が依然として正しい道具です。ブラウザ版は人間のためのものであり、パイプラインのためのものではありません。

プライバシー:アップロード型とローカル実行

構造的な違いは単純です。オンライン変換ツールは、変換が始まる前にあなたのファイルをサーバー上で受け取ります。一方、ブラウザ版も CLI も、自分のハードウェア上で変換を完結させます。これが問題になるかどうかは文書しだいです——しかし、その判断をデフォルトで代行するのはツールではなく、あなたであるべきです。

ローカル実行には、サーバーの約束にはない「検証できる」という利点もあります。変換中にブラウザの Network パネルを開いてみてください。リクエスト一覧は空のままです。エンジンはすでに読み込み済みの WebAssembly バイナリだからです。監査すべきリクエストも、信頼すべき保持ポリシーも、問うべき GDPR の問題もありません。

シーン別の選び方

何もインストールできない PC で、Word のアーカイブを Obsidian、Logseq、wiki へ移行する:ブラウザ版 Pandoc が直接的な答えです。docx を入れればきれいな GFM Markdown が出て、画像は .md とともに抽出されます。EPUB、LaTeX、RST、MediaWiki のソースを一度だけ変換する:これも同じ答えです。これらの形式を読める代替手段はほとんどないのです。

ビルドの一環として数百のファイルを一括変換する:CLI をインストールしてスクリプトを書けば終わりです。ブラウザツールは for ループに敵いません。スキャン画像のみの PDF:どれを選ぶとしても、OCR を備えていることを確認してください。テキストレベルの変換ツールにピクセルは読めません。そしてポリシー上アップロードが禁止された機密文書:どちらの形であれローカル実行を選び、アップロード型のサイトだけは避けてください。

続きを読む

ツールを使う

ブラウザで Pandoc を試す