Markdown を PDF に変換する 5 つの方法を比較（Pandoc、VSCode、オンラインツール）
同じサンプルで Markdown PDF 変換の 5 手法を比較します。ブラウザ一括出力、エディター、CLI、Pandoc を成果物と運用条件に合わせて選べます。導入例と比較表を残し、個別文書、ZIP、結合書籍の違いも確認します。
単発文書ならブラウザ版 /markdown-to-pdf が最小設定です。引用・出版工程は Pandoc、エディタ中心や自動化は VS Code と CLI が向きます。機能、再現性、ローカル管理で選んでください。
この比較は固定の秒数やダウンロード容量ではなく、現在文書化されている機能に基づきます。設定時間とブラウザランタイム容量は OS と版で変わるためです。
適している: 単発変換、コードハイライト、数式、図表、インストール不要。
やり方: /markdown-to-pdf を開き、貼り付けて PDF をクリック。
設定と初回実行: OS、PDF エンジン、キャッシュ、文書の複雑さで変わるため、自分の環境で確認してください。
長所：ローカル導入は不要で、コードハイライト、KaTeX、Mermaid、表、画像、タスクリストに対応します。ログイン後はブラウザから透かしなしで合計 5 回出力でき、その後も透かし付きで無制限に出力できます。Creator は月額 9 米ドルでブラウザの透かしなし出力が無制限、1 米ドルのパスは同出力 1 回分です。API クレジットは別枠です。
対象範囲：個別 PDF ページは入力上限が 1 MB です。複数ファイルは別の有料一括出力ツールで個別出力を ZIP にできます。制限と結合 PDF の方法は一括変換ガイドを参照してください。
いつ使う: 単発変換の 多く はこれで足りる。
適している: 学術論文、独自 LaTeX テンプレート、引用と参考文献、1 ソースから複数フォーマット（PDF + DOCX + EPUB）。
やり方:
brew install pandoc
brew install --cask basictex # or mactex (platform-dependent)
pandoc input.md -o output.pdf
長所: 安定、スクリプタブル、LaTeX による無限のテンプレート。引用ネイティブ対応 (--bibliography)。オフライン動作。書籍品質の組版。
短所：PDF エンジン、フォント、テンプレートの設定が必要です。--syntax-highlighting でテーマを明示し、選んだエンジンの結果を確認します。Mermaid は画像にするか、適切な前処理を設定します。
いつ使う: 本、博士論文、文献付き論文を出版する、または 3 つ以上の PDF テンプレートをバージョン管理したい場合。
適している: VSCode で 1 日中 Markdown を書く人。
やり方: yzane の「Markdown PDF」プラグインをインストール、ファイル右クリック → Markdown PDF: Export (pdf)。
長所：エディターから出力でき、CSS とコード配色を設定できます。現在の READMEは Mermaid と KaTeX の対応を明記しています。導入版と設定を確認してください。
短所：互換性のあるブラウザ実行環境が必要で、設定と CSS が結果を左右します。エディターのプレビュー拡張が PDF 出力にも働くとは限りません。数式、Mermaid、フォント、改ページを PDF で確認してください。
向いている場合：原稿の執筆とレビューをすでに VS Code で行い、同じ作業の中で出力も設定したい場合です。
適している: Markdown が既にブラウザで描画されているページ（GitHub README、GitLab Wiki、ドキュメントサイト）。
やり方: ⌘+P または Ctrl+P → 「PDF として保存」。
長所: そこにある。インストール不要。レンダリングされた HTML なら何でも。
短所：ページの印刷 CSS と印刷設定に依存します。背景、コード配色、ヘッダー、フッター、改ページを確認してください。数式と図はページ上ですでに描画されている必要があります。
いつ使う: 既にレンダリング済みの Markdown ページの PDF が今すぐ必要で、粗さは許容できる場合。
適している: ビルドパイプライン、CI/CD、自動化されたドキュメント。
やり方:
npm install -g md-to-pdf
md-to-pdf input.md
長所: スクリプタブル。ドキュメントごとに YAML front-matter でテーマ指定。watch モード。インストール後はオフラインで動く。
短所：Node.js とブラウザ実行環境が必要です。設定と CSS で外観を調整します。必要な Markdown 拡張を確認し、図が描画されない場合は事前に画像へ変換してください。
いつ使う: ドキュメントサイトが CI で PDF をビルドする；PDF を .md と並べてバージョン管理したい。
リンク先の文書にある正確なパッケージ名を使ってください。md-to-pdf と markdown-pdf は別のパッケージです。導入する版とセキュリティ情報を確認します。
| 方法 | ローカルの準備 | 初回出力 | コード配色 | 数式 | Mermaid | 向いている用途 |
|---|---|---|---|---|---|---|
/markdown-to-pdf | 導入不要 | ブラウザのリクエスト | 対応 | KaTeX | 対応 | 個別文書 |
| Pandoc | PDF エンジンとフォント | 環境に依存 | 構文テーマ | エンジンに依存 | 前処理 | 書籍と引用 |
| VS Code Markdown PDF | 拡張機能と描画環境 | 環境に依存 | 設定可能 | KaTeX | 対応・実行環境を設定 | エディター内の作業 |
| ブラウザ印刷 | 描画済みの元ページ | 印刷ダイアログ | 元ページに依存 | 元ページに依存 | 元ページに依存 | 既存の Web ページ |
md-to-pdf CLI | Node.js とブラウザ環境 | 環境に依存 | 設定可能 | 設定を確認 | 画像を準備 | CI ビルド |
- 大半の読者 →
/markdown-to-pdf。多く のケースの答え。 - 引用付き学術 → Pandoc。
- VSCode 常用 → VSCode プラグイン。
- DocOps / CI ビルド →
md-to-pdfCLI。 - GitHub README が今すぐ要る → ブラウザ印刷、粗さは諦める。
定期実行やコミット時の再生成には自動化を選びます。ときどき処理するファイル群ならブラウザ一括出力でローカル設定を省けます。Pandoc は章の順序、引用、管理するテンプレートを持つ 1 つの出版文書に向いています。
コードハイライトを最もよく保つのは？
Chromium 系はテーマと印刷設定を揃えると Web 風のハイライトを保てます。Pandoc は独自の構文テーマを使います。テーマがそのまま移ると考えず、同じコードで比較してください。ハイライトガイドも参照できます。
バッチ変換できるのは？
複数ファイルは有料の一括出力を使えます。1 回に最大 15 個の Markdown を受け付け、入力ごとに 1 つの出力を ZIP で取得できます。Creator は月 20 回の実行を含みます。PDF を選ぶと個別の PDF ができ、1 つの文書にまとめる場合は Pandoc を使います。
なぜ markdown-pdf ではなく md-to-pdf なのか？
この記事では上にリンクした md-to-pdf を使います。名前は置き換え可能ではありません。別のツールを選ぶ場合は文書、リリース状況、安全性情報を比較してください。
CJK / 中国語フォントの扱いが最も良いのは？
ホスト型 /markdown-to-pdf はサーバー側のフォント環境を使います。ローカル Chromium 系は実行環境のフォントを使い、Pandoc + XeLaTeX は通常 mainfont: などで CJK フォントを明示します。実際の文字でテストしてください。
スケール時に最も安いのは？
ブラウザのプラン、必要なら API クレジット、CI の計算資源、フォント、テンプレート保守を含む総費用を比較します。Creator のブラウザ契約に API 描画クレジットは含まれません。実際の利用量で判断してください。
成果物に合わせ、ブラウザの個別文書、一括出力の ZIP、定期的な CI ビルド、引用を含む Pandoc 文書を選びます。同じサンプルを候補の方法で出力し、実際の PDF を比べてください。
# Document export test
## Handoff checklist
- [x] Headings
- [x] Table layout
- [x] Code formatting
| Check | Expected result |
|:--|:--|
| Body text | Readable at page width |
| Links | Retained in PDF |
> Demo content for comparing export methods.
検討中の各方法でこのデモ入力を使ってください。ここに示すのは製品の出力例であり、5 ツールを計測したベンチマークではありません。各 PDF で表の枠、タスクの印、文字の選択を確認します。
上記の制限とコマンドは、次の最新一次資料で確認しました：
MarkdownToImage を開いて Markdown を描画し、用途に合う形式を選びます。バッチ自動化の前に代表的な文書 1 件で検証してください。