TidyReads

MARKDOWN TO EPUB · YOUR NOTES, READY TO READ

Markdown to EPUB.
Give your notes a book.

Collect your Markdown writing into a reflowable ebook. Bring chapters and local images together, then read with adjustable text in your favorite EPUB reader.

Bring your Markdown

Upload one MD file, or a ZIP containing chapters and images.

Up to 20 Markdown files per ZIP, ordered by filename. Images stay with their relative paths.

No sign-up needed to check and preview. Create a free account to export. Already a reader? Sign in

Free file checks and a sampled PDF preview of up to 15 pages. Verify your email before exporting. Files expire after 48 hours.

Download a Markdown + images sample ZIP →

From a folder of notes to an EPUB

Export your notes as standard Markdown, put the chapters and images in a ZIP, and upload the archive. We combine the Markdown files in filename order. Prefix filenames with 01, 02 and 03 to set the reading sequence, then check the imported order before exporting. Headings become entries in the book's table of contents.

Include images with a ZIP

Keep the same folder structure as your Markdown image links. For example, ![Diagram](images/diagram.png) in 01-introduction.md should point to images/diagram.png inside the ZIP.

my-book.zip
├── 01-introduction.md
├── 02-next-chapter.md
└── images/
    └── diagram.png

PNG, JPEG, GIF, WebP, BMP and TIFF images are accepted; animated images use their first frame. Remote image URLs are not downloaded. ZIPs are limited to 500 entries and 100 MB after decompression; combined Markdown text is limited to one million characters.

Set the title and author your e-reader shows

Add YAML front matter at the start of your first file. The title and author appear in your library on Kindle, Apple Books or any EPUB reader. You can still change the title before exporting.

---
title: My Reading Notes
author: Alex Reader
language: en
---

Read it on Kindle and other e-readers

Amazon's Send to Kindle accepts EPUB files, so the exported book can go straight to your Kindle library, where text size and margins are adjustable. Signed-in users can also send it from the download page in one step. Kobo, Apple Books, BOOX and most reading apps open EPUB directly.

How this compares with pandoc or Calibre

If you are comfortable with the command line, pandoc converts Markdown to EPUB for free, and Calibre can edit the result. TidyReads is for people who want a review step and a preview instead: upload, check the chapter order and images, and download an EPUB styled for reading without writing a configuration file.

Supported Markdown and current limits

Headings, paragraphs, lists, block quotes, tables and fenced code blocks are imported into the reading layout. Footnotes become numbered notes at the end of each source document. Code uses a monospace font and light shading; it is not syntax-highlighted. Math formulas, Mermaid diagrams and Obsidian [[wikilinks]] are not specially rendered.

Need a printable version?

Convert Markdown to PDF for fixed pages, printing and sharing. When exporting, you can choose any combination of EPUB, PDF, Word and plain text. See pricing and allowances or the conversion guide.