epub.tools notes

Reading my own blog as a book

Mataroa has a feature I did not expect from a minimalist blog platform: it will export your whole blog as an EPUB. Every post becomes a chapter, with a table of contents and an author page. It is under Export, next to the Markdown, Zola and Hugo options.

I run a small site called epub.tools, which makes a browser EPUB reader and an EPUB-to-PDF converter, so this feature caught my eye. This blog is new, so there is not much to export yet. But the idea is worth writing down now: a blog read as a book looks very different from a list of posts.

Why read your blog as a book

On the web, every post stands alone. You read it on the day you publish it, maybe fix a typo, and move on. In a book, the posts sit next to each other, and you start to notice things like:

  • The same opening sentence used in three posts.
  • A promise ("more on this next week") that was never followed up.
  • Links that are now dead, or point to pages that changed.
  • Posts that only made sense in the week they were written.

None of this is visible in an archive page. All of it is visible on page forty of a book.

Reading it

Open the exported file in an EPUB reader. The EPUB reader on my own site is one option. It reads the file in the browser and does not upload it, which suits proofreading drafts. Any EPUB app works too; use whatever you already have.

The features that help with this kind of reading:

  • The table of contents, to see the shape of the blog at a glance. It is surprisingly useful to see all titles in one column.
  • Full-text search, to find every place a tired phrase shows up.
  • Highlights and notes, to mark what needs fixing. The notes can be exported as Markdown, which is convenient when the blog itself is written in Markdown: the list of fixes and the posts are in the same format.

Then go back to Mataroa and edit the posts. The EPUB is just a reading copy; the blog is still the source.

Printing it

Sometimes paper is better. A year of posts on paper is a nice thing to have, and a printout is a good way to proofread long pieces.

Mataroa already has a Print export that renders all posts on one page, and its export page says plainly that this is useful for turning the blog into a PDF. If that is all you need, use it. It is simpler than anything I am about to describe.

If you want book-shaped pages instead, you can run the EPUB through EPUB to PDF. Unlike the reader, this uploads the file to a server for conversion, with a preview before you download. A public blog is public anyway, but it is worth knowing.

Things to check in the preview:

  • That chapters are in the expected order.
  • Code blocks and tables. Wide tables can lose columns when the page width is fixed.
  • Images. Small images look rough when they are scaled up to the page.

What to fix after a read-through

The usual fixes are small: delete or merge posts that only made sense in their week, add real dates where a post says "this week", repair dead links, and cut repeated openings. None of this is dramatic, but it is hard to see one post at a time.

If you write on Mataroa and have never tried the book export, it takes one click. Reading it is the part that takes an evening.


Drafted with AI assistance; reviewed and edited by the author, who runs epub.tools.