Markdown to EPUB Converter
Convert markdown to EPUB and EPUB to markdown in your browser. Chapters from headings, cover and metadata included. Free ebook converter, no signup.
- Chapter 1: Arrival45 words · ch001-chapter-1-arrival.xhtml
- Chapter 2: The First Night75 words · ch002-chapter-2-the-first-night.xhtml
- Chapter 3: Fog43 words · ch003-chapter-3-fog.xhtml
EPUB 3 with a navigation document, toc.ncx for older readers and a small stylesheet. Built in your browser; nothing is uploaded.
What Is a Markdown to EPUB Converter?
A markdown to epub converter packages a markdown manuscript as an EPUB ebook: each chapter becomes an XHTML file, the headings become the table of contents, and the metadata (title, author, language, identifier, cover) goes into the package document so e-readers, Apple Books, Google Play Books and Kindle can shelve the book correctly.
This markdown to ebook tool follows the EPUB 3 specification and includes an NCX file for older EPUB 2 readers. The reverse direction reads any unencrypted EPUB and gives you the chapters back as markdown.
How to Convert Markdown to EPUB
- Paste the manuscript or open a .md file. Front matter with title and author is read automatically.
- Check the chapter list on the right; use # (or ## with the selector) to start each chapter.
- Fill in the title, author and language. Add an ISBN or URL as the identifier if you have one, otherwise a UUID is generated.
- Optionally choose a cover image (portrait JPG or PNG).
- Click Download EPUB and open the file in your reader, or send it to Kindle.
What Is Inside the EPUB File
| File | Purpose |
|---|---|
| mimetype | First entry, stored uncompressed, identifies the container |
| META-INF/container.xml | Points readers at the package document |
| OEBPS/content.opf | Metadata, manifest of every file, spine (reading order) |
| OEBPS/nav.xhtml | EPUB 3 table of contents |
| OEBPS/toc.ncx | EPUB 2 table of contents for older devices |
| OEBPS/ch001-….xhtml | One well-formed XHTML file per chapter |
| OEBPS/style.css, cover.jpg | Typography and the optional cover |
Markdown to Kindle and Other Readers
Kindle accepts EPUB through Send to Kindle, so a markdown to kindle workflow is: download the EPUB here, then email it to your Kindle address or drop it on the Send to Kindle page. Apple Books and Google Play Books open the file directly. Calibre can convert it further to MOBI or AZW3 if you need those formats. Keep images small (under 1 MB each) and use relative headings consistently so the table of contents is useful on a small screen.
EPUB to Markdown and Editing Ebooks
The epub to markdown direction is useful for editing a book you wrote elsewhere, extracting your own notes, or moving content into a wiki. Open the file, review the chapter list, then copy or download the markdown; you can edit it in the markdown editor and rebuild the ebook with the markdown to epub converter. Books with DRM cannot be opened, and highly designed fixed-layout books lose their layout, since markdown only keeps the text structure.
Frequently Asked Questions
How does the markdown to epub converter split chapters?
Every level-1 heading starts a new chapter and becomes its title in the table of contents. Switch New chapter at to Heading 2 if your manuscript uses # for the book title and ## for chapters. Text before the first heading becomes a front matter chapter.
Will the EPUB open on a Kindle?
Yes. Amazon accepts EPUB through Send to Kindle and the Kindle app, so markdown to kindle is the same file: download the EPUB and send it by email or the web uploader. Older Kindle models that only read MOBI need a conversion in Calibre first.
Can I convert an EPUB back to markdown?
Switch the direction to EPUB to Markdown and open the file. The chapters are read in reading order from the package spine, converted from XHTML to markdown, and joined with their headings. The title and author from the metadata become front matter.
Is the file built on a server?
No. The markdown to epub build runs in your browser: the markdown is rendered to XHTML, packaged with the navigation document, content.opf and stylesheet, and zipped with the mimetype entry first as the standard requires. Nothing is uploaded.
What markdown features are supported in the ebook?
Headings, paragraphs, emphasis, lists, blockquotes, tables, code blocks, links and images by URL. Math is rendered with KaTeX markup, which most modern readers display. Mermaid diagrams are kept as code because readers cannot run scripts.