Markdown → EPUB
Converting a novel from Markdown (.md) to EPUB (.epub) is a routine step in practice — EPUB is the universal e-book format: it adapts to any screen and font size, and carries a table of contents. Fortunately Markdown and EPUB are structurally close, so there is not much to lose. Below we explain in detail how Markdown becomes EPUB and what to watch out for, and the page ends with a converter that does the job right in your browser — nothing is uploaded, the file never leaves your machine.
What is Markdown?
Markdown is plain text plus markers (# headings, ** bold, | tables) — effectively a superset of .txt. Any text editor opens it, and it versions cleanly in Git. Its expressiveness is deliberately limited: no pagination, no headers or footers, no precise control over type size or position, and no complex layouts. Those trade-offs make Markdown an excellent authoring and conversion source, but as a final reading format its experience depends entirely on which app opens it. Read the Markdown format guide
| Extensions | .md |
|---|---|
| Typical use | Authoring, notes and technical docs; a clean intermediate format before converting to EPUB or TXT. |
What is EPUB?
EPUB is the most portable e-book format outside the Kindle ecosystem. It is really a ZIP archive holding XHTML content, CSS, images and a manifest that fixes the reading order. Because content and presentation are stored separately, the same file re-lays-out itself for a phone, a tablet or a desktop, and the reader can change the font size at any time. The table of contents, cover, title and author all have standard places, so library software recognises and sorts the book correctly. For text-heavy fiction, EPUB is usually the safest format to distribute and to keep long term. Read the EPUB format guide
| Extensions | .epub |
|---|---|
| Typical use | Mainstream e-book distribution and long-form reading, especially text-heavy books such as novels. |
How to convert Markdown to EPUB
Markdown is plain text carrying almost no structure beyond heading levels: no pagination, no headers or footers, no way to express precise type size or position, and limited tables and nested lists. Before converting to a layout-sensitive format, check the source does not rely on those.
EPUB is not just a ZIP: it must contain mimetype (as the first, uncompressed entry), META-INF/container.xml, the content OPF and a nav document. Miss one and readers report a corrupt file, so prefer a mature converter over hand-building the archive.
The source carries no metadata at all — plain-text formats such as TXT and Markdown are the classic case — while the target expects a title and author. Converters fall back to the filename, so libraries fill up with "Untitled" or titles still carrying the .txt or .md suffix — fill them in during conversion.
Chapter headings in the source are ordinary lines while the target demands a real table of contents. Converters try to match patterns such as "Chapter N"; when the match is poor the TOC is garbled or the book has a single chapter. Check that TOC entries match the actual chapter count.
Going from a single text file to a structured archive adds information: the tool must generate the manifest, the navigation document and metadata for you. The quality of those generated parts — accurate chapter splitting, correct language tags — decides whether the result is usable.
Convert Markdown to EPUB
MARKDOWN → EPUB
These settings are written into the EPUB. The font size is relative, so readers can still adjust it themselves.
The conversion runs entirely in your browser — your file is never uploaded.
A novel reader that syncs your progress across every platform
Tide Reader opens TXT and EPUB, detects chapters on import, lays the text out the way you like it, and syncs your reading position across Windows, macOS, iOS and Android. Drop the converted file in and start reading.
Download Tide ReaderTXT and EPUB; local-first reading, with optional cloud sync and WebDAV.