最終更新日:2026年11月11日
MarkdownをEPUBに変換するいちばん手早い方法はPandocです。pandoc book.md -o book.epubを実行するだけで、規格に沿ったEPUBができあがります。何もインストールしたくなければ、Convert2EPUBのようなWebの変換ツールに.mdファイルをアップロードしましょう。どちらの方法でも、電子書籍の質は、変換前に見出しとメタデータをどう組み立てるかでほぼ決まります。
MarkdownファイルをEPUBに変換するには何が必要?
必要なのは、見出しの構造がはっきりしたMarkdownファイル、タイトルと著者、そしてEPUBを書き出せるツールです。定番のコマンドラインツールはPandocです。ブラウザで使う変換ツールなら、インストールなしで同じことができます。
変換の前に、元のファイルの準備ができているか確認しましょう。
- 1章につき
#見出しを1つ。Pandocのユーザーズガイド(英語)によると、Pandocは初期設定でレベル1の見出しごとにEPUBを章に分割します。章を##で書いている場合は、書き換えるか、分割レベルを設定してください(後述)。 - タイトルと著者はメタデータブロックに。見出しに書くだけでなく、ファイル先頭のメタデータブロックに入れておきます。
- 画像は相対パスで。コマンドを実行する場所から解決できる相対パスにし、代替テキストも付けます。
- なくては困るような生のHTMLは使わない。簡単なタグならたいてい残りますが、スクリプト、iframe、CSSの小技は電子書籍リーダー用のファイルには向きません。
PandocでMarkdownをEPUBに変換するには?
Pandocをインストールし、ファイルの先頭にYAMLのメタデータブロックを置いて、コマンドを1つ実行します。目次はPandocが見出しから作ってくれます。
1. メタデータを追加する
Pandocのマニュアルにあるとおり、PandocはEPUBのメタデータを、Markdownファイル内のYAMLブロックか、別のYAMLファイルから読み込みます。最小限のブロックは次のとおりです。
---
title: The Lighthouse Letters
author: Dana Whitfield
lang: en-GB
date: 2026-11-11
cover-image: cover.jpg
---
langは、思っている以上に重要です。一部のリーダーでは、ハイフネーションや読み上げ機能がこの値で決まります。日付は自由に決められるので、表示したい発行日を入れましょう。
2. コマンドを実行する
pandoc book.md -o book.epub --toc --toc-depth=2
--toc-depthは、目次に表示する見出しのレベル数を指定します。Pandocのマニュアルによると初期値は3で、レベル1、2、3が一覧に載ります。小説なら、たいてい1か2のほうがすっきりします。--epub-cover-image=cover.jpgは、cover-imageフィールドと同じ働きをします。Pandocは、幅・高さとも1000px未満の表紙画像を推奨しています。--epub-title-page=falseを付けると、自動生成されるタイトルページが省かれます。自分でタイトルページを書いた場合に使います。
3. 複数のファイルをまとめる
1章ごとに1ファイルで管理している書き手は多いでしょう。ファイルを順番に指定すれば、Pandocがつなげてくれます。
pandoc 01-intro.md 02-first-night.md 03-storm.md -o book.epub
シェルでの並び順が読む順と一致するよう、ファイル名の先頭に番号を付けましょう。メタデータブロックは最初のファイルにだけ入れます。
4. スタイルは控えめに
Pandocは標準のスタイルシートを適用します。変更するには--css=epub.cssを指定します。CSSは最小限にとどめましょう。段落の字下げと見出しの余白は設定しても、フォントの種類とサイズには手を付けないでください。どちらもリーダーで読者が選べるもので、上書きするとその自由を奪ってしまいます。
章と目次を正しく作るには、見出しをどう組み立てる?
章には#、章の中の節には##を使い、レベルを飛ばさないようにします。EPUBのナビゲーションメニューはこれらの見出しから作られるので、書いた構造がそのまま読者に届く構造になります。
| Markdownの書き方 | EPUBでの扱い(Pandocの初期設定) |
|---|---|
# Chapter | 新しい章のファイルが始まり、目次に表示される |
## Section | 目次に表示される(初期値の深さは3)が、章のファイルの中にとどまる |
### Subsection | 深さの設定が許す場合だけ目次に表示される |
| 見出しのように見せた太字 | 見出しではないので、目次には表示されない |
よくある問題が2つあります。
#見出しが1つしかない本。本全体が1つの大きなファイルになります。Pandocのマニュアルによると、この分割の設定が影響するのはEPUBの内部構成だけで、読者から見た章の表示は変わりませんが、章のファイルが非常に大きいと動作が遅くなるリーダーもあります。最上位の見出しが少ない長い文書では、--split-level=2または3を使いましょう。- タイトルを
#で書き、章も#で書いている。この場合、タイトルが章として表示されてしまいます。タイトルはYAMLブロックに入れ、#は本当の章だけに使いましょう。
それでも目次がおかしい場合は、EPUBの目次がない・壊れているときの直し方のガイドで確認の手順を紹介しています。
Pandocをインストールせずに変換する方法は?
あります。.mdファイルに対応したWebの変換ツールなら、アップロードしてタイトルと著者を設定し、EPUBをダウンロードするだけです。一度きりの変換や、コマンドラインを使いたくない人に向いています。
2つの方法を比べると、次のようになります。
| Pandoc | ブラウザの変換ツール | |
|---|---|---|
| インストール | 必要 | 不要 |
| ビルドスクリプトやCIでの繰り返し実行 | できる | できない |
| 独自のCSS、フォント、フィルター | 自由に制御できる | ツールの設定の範囲内 |
| 複数ファイルの結合 | ファイルを列挙すればできる | 先に1つのファイルにまとめる |
| 向いている用途 | 何度も作り直す本 | たまに手早く変換したいとき |
Convert2EPUBのアップロード欄は対応形式にMarkdownを含み、上限は100 MBです。タイトル、著者、リフロー型か固定レイアウトか、端末を設定できます。無料のStandardモデルは、サイトの説明によれば小説のようなシンプルなレイアウトに向いており、ほとんどのMarkdown原稿もまさにそうしたレイアウトです。リフロー型でよいか迷ったら、リフロー型と固定レイアウトのEPUBの比較をご覧ください。文章が中心なら、リフロー型で間違いありません。
EPUBをリーダーに送る前に確認することは?
少なくとも1つの実際の読書アプリでファイルを開き、短いチェックリストで確認します。MarkdownからEPUBへの変換で起きる問題のほとんどは、最初の5分で見つかります。
- 目次:ナビゲーションメニューを開きます。すべての章が、わかりやすい名前で順番どおりに並んでいるはずです。
- 表紙とタイトル:ライブラリの一覧に表紙が表示され、タイトルと著者が正しく表示されているはずです。
- 画像:どの画像も表示され、画面に合わせて縮小され、余計な枠線がないかを確認します。
- コードブロックと表:小さなリーダーでは、コードブロックの長い行が画面からはみ出すことがあります。折り返すか、短くしましょう。幅の広い表は、6インチの画面向けにはリストに書き換えたほうが読みやすくなります。
- 脚注:PandocはMarkdownの脚注をリンク付きの注に変換します。1つタップしてみて、元の位置に戻れることを確かめましょう。
- 検証:ストアで出版する予定があるなら、W3Cが支援する検証ツールで、多くのストアが使っているEPUBCheckにファイルを通しましょう。リーダーでは何事もなく表示されてしまう問題も見つけてくれます。
小さなE Ink画面については、6インチE Inkリーダー向けのEPUB設定の記事で、ファイルで決めることと端末で決めることを説明しています。
準備の手間を省きたいなら、.mdファイルをConvert2EPUBにアップロードして、リフロー型のEPUBをダウンロードできます。
Markdownから作ったEPUBはKindleで読める?
はい。メールかSend to KindleアプリでEPUBをKindleに送れば、MOBIやAZW3に変換する必要はありません。Convert2EPUBのページでも、Send to KindleならEPUBをそのまま送れると案内しています。手順はEPUBをKindleに送る方法のガイドにまとめています。
よくある質問
PandocでMarkdownを直接MOBIやAZW3に変換できますか?
いいえ。Pandocが書き出せるのはEPUBで、MOBIやAZW3は書き出せません。現在のKindleではEPUBを直接扱えるので、別途変換する必要はたいていありません。MOBIが必要なのは、かなり古いKindleだけです。
EPUBが1つの巨大な章になってしまうのはなぜですか?
Pandocは初期設定で、レベル1の見出しごとに章を分割します。Markdownに#が1つしかないか、まったくない場合は、すべてが1つのファイルに入ります。章の見出しを#に変えるか、--split-level=2を設定してください。
表紙画像を追加するにはどうすればよいですか?
YAMLブロックにcover-image: cover.jpgを追加するか、--epub-cover-image=cover.jpgを指定します。Pandocのマニュアルでは、幅・高さとも1000px未満の画像が推奨されています。パスは、コマンドを実行する場所からの相対パスにしておきましょう。
太字、リスト、引用などのMarkdownの書式は残りますか?
はい。標準的なMarkdownの要素はEPUBの中で対応するHTMLになり、リーダー自身のスタイルで表示されます。拡張記法の扱いはツールによって異なるので、定義リストやタスクリストのような珍しい記法は、出力で確認してください。
フォルダー内のMarkdownファイルをまとめて変換できますか?
Pandocならできます。DEV Communityの解説記事(英語)がドキュメントのリポジトリで行っているように、ファイルを順番に列挙するか、*.mdのようなワイルドカードを使います。順番が予測できるよう、ファイル名に番号を付けておきましょう。
手持ちのPDFを変換してみませんか?一般的なテキスト文書なら無料で、アカウント登録も不要です。
PDFをEPUBに変換 →