1．はじめに

Pandocは、多様な文書形式を相互に変換できる非常に強力なツールです。Markdown、HTML、LaTeX、Word（*.docx）、PDFなど、幅広いフォーマットに対応しており、ドキュメント作成や変換作業を効率化します。
Pandocはコマンドラインツールであるため、一般的にはバッチファイルを作成して使用します。しかし、オプションを変更するたびにバッチファイルを編集する必要があり、不便に感じることもありました。そこで、Pandocをより簡単に活用できる専用のツールアプリケーション「PandocTool」を作成しました。

2. ソフトの概要

2-1. 動作環境

「PandocTool」は、Pandoc を使用して、Markdownファイルを、

• EPUB3(電子書籍)
• HTML
• PDF
• DOCX

の文書形式に変換するWindow用のアプリケーションソフトです。

※ PDF への変換には、wkhtmltopdfが必要です。

3．事前準備

「PandocTool」を使用するには、事前に Pandoc 及び wkhtmltopdf をインストールする必要があります。

3-1. Pandoc のインストール

Pandoc のWebページの「Installing」をクリックし、そのページの「Download the latest installer」ボタンをクリックするか、Windowsであれば、Windowsの項の「download page」をクリックしてダウンロードページを表示します。

• Pandoc - Installing pandoc

• Release pandoc 3.6.1 [2025/01/06時点]
  • Windowsの場合は、「pandoc-3.6.1-windows-x86_64.msi」でインストールを行うとパスも登録されます。
    インストール先は、“C:/Program Files/Pandoc” となります。

※ 最新版は、64ビットのみとなります。32ビットのPandocを使用したい場合は、古いバージョンをお使いください。

3-2. wkhtmltopdf のインストール

wkhtmltopdf のインストールは、以下の公式Webページから可能です。
「wkhtmltopdf」をコマンドラインから利用するには、パスを通す必要があります。そのため、以下の手順を実行してください。

1. 7zArchive版をダウンロード
   • インストーラ版ではなく、7zArchive版を選択してください。
2. ダウンロードしたファイルを解凍
   • 解凍すると、binフォルダが作成されます。
3. binフォルダ内のファイルをコピー
   • binフォルダ内のすべてのファイルを、先ほど「Pandoc」をインストールしたディレクトリ（例: C:/Program Files/Pandoc）にコピーしてください。

これにより、「wkhtmltopdf」も自動的にパスが通るようになります。

• wkhtmltopdf

4．「PandocTool」のインストール

「PandocTool」をインストールする手順は、以下の通りです。

1. ダウンロードした「PandocTool_V***.zip」を適当なフォルダに解凍してください。
2. Windowsの環境に合わせて、PandocTool.exe（Win32）か、PandocTool.exe（Win64）のどちらかを使用してください。

※ どちらをインストールしたら良いか判らないときは、PandocTool.exe（Win32） をお使いください。

5．各設定

最初に、設定ダイアログを開き、各設定を行ってください。
設定ダイアログは、次のいずれかの方法で開くことができます。

1. メインメニューの「設定」→「Pandocの設定」から
2. 「設定」ボタンをクリックして

5-1.「フィルの設定」タブ

「フィルの設定」タブでは、以下の設定・確認ができます。

• Pandoc
  • パスが通っているかチェックできます
  • フルパスで指定する事もできます
• wkhtmltopdf
  • パスが通っているかチェックできます
• Markdownの形式の選択(-f: 入力形式の指定)
• スタイルシートの設定

5-1-1. パスが通っているかチェック

パスが正しく設定されているかどうかは、以下のダイアログ表示で確認できます。

• パスが通っている時
  

• パスが通っていいない時
  

5-1-2. スタイルシート

スタイルシート（CSS）には、CSS（Cascading Style Sheets）ファイルを登録します。ファイルをDrag&Dropするか、「参照」ボタンをクリックして登録したいファイルを選択してください。
スタイルシート（CSS）を使用すると、HTML文書のフォント、サイズ、色、さらにはレイアウトなどの外観を自由に変更することができます。
サンプルとして同梱している「stylesheet_orange.css」は、ぜひここに登録してお試しください。また、作者の電子書籍「電子書籍出版・技術文書作成を劇的に加速！秀丸エディタ + Markdown + Pandocの驚異」では、さらに２つのサンプルスタイルシートを紹介しています。ご興味がありましら、ぜひご確認ください。

それから、以下のWebサイトも参考にしてください。

1. A collection of portable pandoc templates with no dependencies

   • 依存関係のないポータブルな Pandoc テンプレートのコレクションです。
   • サンプルのCSSファイルに加え、HTMLのテンプレートファイルも公開されています。
   • https://github.com/ryangrose/easy-pandoc-templates

2. The minimal amount of CSS to replicate the GitHub Markdown style

   • GitHub Markdownスタイルを再現するための最小限のCSSです。
   • https://github.com/sindresorhus/github-markdown-css

3. あなただけのHTMLを作成するための、CSSリンク集 | KeiYouのソフト館

   • 作者のCSSに関する参考リンク集のWebページです。
   • https://progkeiyou.com/cssfile_info/

5-2.各ファイル形式のオプション設定

各ファイル形式変換する時のオプションを設定します。
オプションの紹介は、「Pandoc」、「wkhtmltopdf」のドキュメント および、作者の電子書籍「電子書籍出版・技術文書作成を劇的に加速！秀丸エディタ + Markdown + Pandocの驚異」を参照ください。

5-2-1.「EPUB3」タブ

EPUB3（電子書籍）形式への変換時に使用するオプションを設定します。

5-2-2.「HTML」タブ

HTML 形式への変換時に使用するオプションを設定します。

5-2-3.「PDF」タブ

PDF 形式への変換時に使用するオプションを設定します。
このモードは、「Pandoc」の “–pdf-engine=wkhtmltopdf” オプションを使用して、MarkdownファイルをPDFファイルに変換します。

※ PDF への変換には、wkhtmltopdfが必要です。

5-2-4.「HTML->PDF」タブ

このモードは、「Panoc」で、MarkdownファイルをHTMLファイルに変換後、「wkhtmltopdf」で、そのHTMLファイルをPDFファイルに変換します。
ここでは、「Panoc」と「wkhtmltopdf」、それぞれのオプションを設定します。
文字を大きめに変換したい時は、このモードを使用してください。

※ 同名のHTMLファイルが存在する場合、上書きされますのでご注意ください。
※ PDF への変換には、wkhtmltopdfが必要です。

5-2-5.「DOCX」タブ

DOCX（ワード）形式への変換時に使用するオプションを設定します。
このモードでは、CSSファイルは使用できません。

6. 「Pandoc」の実行

上記の設定を完了すると、「PandocTool」を使ってMarkdownファイルをさまざまな形式に変換できるようになります。
変換を実行する手順は、以下の通りです。

1. 変換するファイル形式／モードを選択します。
2. 変換するMarkdownファイルを選択します。
3. 出力フォルダ、出力ファイル名を設定します。
4. スタイルシートを選択します。
5. 目次を作成するセクションレベルを設定します。
6. 「変換」ボタンをクリックして、「Pandoc」を実行します。

6-1. 変換するファイル形式／モードを選択

ファイル形式／モードを、以下の中から選択します。
デフォルトは、「EPUB3 （電子書籍）」です。

1. EPUB3 （電子書籍）
2. HTML
3. PDF
4. HTML -> PDF
5. DOCX

6-2. 変換するMarkdownファイルを選択

変換するMarkdownファイルは、以下のいずれかの方法で選択できます。
また、複数のファイルを同時に選択することも可能です。

1. エクスプローラーなどからMarkdownファイルをDrag&Dropする。
2. 「参照」ボタンをクリックし、ファイル選択ダイアログからファイルを選択する。

6-3. 出力フォルダ、出力ファイル名を設定

出力フォルダおよび出力ファイル名を指定できます。

6-3-1. 出力フォルダ

「出力するフォルダを指定する」をチェックすると、「出力フォルダ」で指定したフォルダにファイルが出力されます。チェックを外した場合は、変換元のMarkdownファイルと同じフォルダに出力されます。

6-3-2. 出力ファイル名

「出力するファイル名を指定する」をチェックすると、指定したファイル名で出力されます。チェックを外した場合は、変換元のMarkdownファイル名の拡張子を変更したファイル名で出力されます。

6-4. スタイルシートを選択

スタイルシートを使用する時は、「スタイルシート（CSS）を使用する」にチェックを入れ、使用するスタイルシートを選択します。
5-1-2項で、登録したスタイルシートが使用可能です。

6-5. 目次を作成するセクションレベルを設定

「目次を作成する」をチェックすると、目次を含めて出力できます。また、目次を作成するセクションレベルの範囲を設定することが可能です。デフォルトのセクションレベルは「3」です。

6-6. 「変換」ボタンをクリックして、「Pandoc」を実行

「変換」ボタンをクリックすると、「Pandoc」によってファイル形式が変換されます。

7. その他

7-1. アンインストールの方法について

1. 解凍した「PandocTool_V***.zip」及び、インストールした「PandocTool.exe」、「PandocTool.ini」ファイルを削除してください。「PandocTool.exe」は、レジストリは使用していません。
2. 必要に応じて、「Pandoc」、「wkhtmltopdf」を削除してください。

7-2. 使用コンポーネントについて

「PandocTool」は、「Pandoc」を実行するのに、DOSCommandコンポーネントを使用しています。 詳細は、以下のWebページを参照ください。

• GitHub - TurboPack/DOSCommand: This component let you execute a dos program (exe, com or batch file) and catch the ouput in order to put it in a memo or in a listbox.

• DOSCommandコンポーネントの使い方 | KeiYouのソフト館

7-3. 参考Webページ

以下のWebページも参考にしてください。

7-4. サポート

問い合わせは、メール（E-Mail または、ホームページのお問い合わせ）にてお願いいたします。

連絡先

• Email
  • programmerkeiyou@gmail.com
• ホームページの問い合わせページ
  • https://progkeiyou.com/contact/
    

ホームぺージ： https://progkeiyou.com/

7-5. 著作権について

このソフトに関するすべての権利は、作者である Programmer KeiYou に属するものとします。

7-6. 免責事項

このソフトの使用により生じたあらゆる結果について、著作権者は一切の責任を負いません。本事項に同意いただけない場合は、使用をお控えくださいますようお願い申し上げます。

バージョン情報

2025/01/08 Ver1.00 公開