thoughtasylumTOOLBOX Preview Guides Use offline Automate Feedback

Tools › Documents

Markdown to EPUB

Turn Markdown into an EPUB ebook: chapters from its headings, a table of contents, a cover, the pictures it uses, and the metadata and accessibility details stores ask for.

About this tool What it's for, how to use it and an example

What it's for

Make an ebook from text you’ve written in Markdown, the plain-text format with # headings and *emphasis* that many writing apps export. The EPUB it makes opens in Apple Books, Kobo, Google Play Books and most reading apps, and can be sent to a Kindle, with chapters, a table of contents and a cover.

For example, when you’ve written a family history or a club handbook in a notes app, export it as Markdown, paste it here with a cover photo, and give the EPUB to anyone with an e-reader.

How to use it

Give the Title (and Author), and the Language as a code such as en, en-GB or fr. Type or paste the Markdown, or open one or more Markdown files (several are joined in name order, so 01-intro.md, 02-… work). A new chapter starts at each # heading, or each ## with New chapter at set so; the chapter list updates as you type.

  • Cover picture: a JPEG or PNG, ideally about 1600 × 2560 pixels.
  • Pictures the text uses: add the files that ![description](photo.jpg) lines name; they’re matched by file name, wherever the Markdown says they are.

Make the EPUB saves it, named from the title. The language and chapter setting are remembered in this browser.

Example

Press Try an example, or give the title The Lighthouse Keeper and paste:

# The Storm

The wind rose at dusk, and **nobody** came.

# Morning

By morning the sea was *glass*.

The chapter list shows The Storm and Morning. Make the EPUB saves the-lighthouse-keeper.epub; open it in the EPUB Checker and it reports no problems apart from having no cover.

Good to know

Markdown is turned into HTML as GitHub does (tables, task lists and strikethrough included); HTML written inside it is kept, apart from scripts and embedded frames. Pictures from the web aren’t fetched, as readers don’t show them: their descriptions appear instead. The book uses a simple built-in style; fonts aren’t embedded, so readers use their own.

It’s an EPUB 3 with an EPUB 2 table of contents for older readers, and accessibility metadata that stores ask for. Everything is made in your browser.

Guide: Publishing an ebook that stores accept

Private: this tool runs in your browser. Nothing you type, paste or choose leaves this page.

Saved you a few minutes? Say thanks with a coffee.

Something wrong with this tool, or missing from it? Report a bug or suggest a feature.

↑ ↓ move↵ openesc close