Pandocを使ってMarkdownをEPUBファイルに変換する

Pandocとは？

Pandocは、さまざまな形式の文書を変換できる強力なツールです。Pandocを使うと、Markdown文書から簡単にePubファイルを作成できます。

Pandocのインストール方法

WindowsとmacOSでは、それぞれChocolateyとHomebrewを使って簡単にインストールできます。

macOSのインストールコマンド

brew install pandoc

Windowsのインストールコマンド

choco install pandoc

Pandocを使った変換方法

ターミナルで次のようにMarkdownファイルと生成するEPUBファイル名を指定して実行すると、EPUBファイルが作成されます。

コマンド例は次のとおりです。

pandoc note.md -o note.epub

ここで、note.mdは入力するMarkdownファイル名で、-o（--output）オプションにより出力するEPUBファイルとしてnote.epubを指定しています。

EPUBファイルを生成するときに--cssオプションを使うと、EPUB生成に使用するCSSファイルを指定できます。CSSファイルを指定せずにEPUBを生成すると、少し見栄えのよくない結果になることがあります。GitHub Markdown CSSやその他のカスタムCSSを使って変換することをおすすめします。

詳しいインストール方法と使い方は、Pandoc公式ページで詳しく紹介されています。

便利なオプション

使用例

pandoc source.md -o dest.epub -t epub3 --toc --toc-depth=3 --css=mystyle.css --epub-cover-image=mycover.jpg

生成されたePubファイル

変換されたEPUBファイルをプレビュービューアーや電子書籍リーダーで確認します。レイアウト、画像、リンクなどが正しく表示されるか確認します。

必要に応じてEPUBファイルを修正し、追加編集を行います。Calibreのようなツールを使ってEPUBファイルを編集できます。

参考

• Markdownを使ってEPUBを作る
• Pandocのインストールと使い方