Introduction

At Electric Book Works, we’d been producing books with InDesign for years. InDesign is awesome, but it makes publishing simultaneously to print and digital formats a real pain. No matter how we set things up, we always ended up with separate master files: one for print, one for the ebook, and one for the website. And keeping those in sync over time was almost impossible.

We needed a way to instantly create PDF (for high-end, professional book publishing), epub and website editions of a book from a single master source. We needed great version control and cloud backup. We wanted to be able to edit from anywhere, in a way that is easy for non-technical people to learn.

And we didn’t want to be locked into proprietary tools, whose price or availability could change at any time. We needed to use open-source technologies to ensure our content was future-proof. And we didn’t want to develop code that others had already developed as open-source.

We spent several years piecing together a solution, bit by bit. Eventually, we settled on a workflow that is simple and powerful:

  1. We store a book’s master files in plain text, formatted as markdown.
  2. We turn that plain text into clean HTML instantly (using Jekyll).
  3. We apply stylesheets to that HTML to generate beautiful web versions, ebooks and print PDFs instantly.
  4. Everything is stored securely with state-of-the-art version-control (using GitHub).

Markdown is so simple that non-technical people can learn how to create and edit it in under an hour. They can even work directly on the master files online (on GitHub.com, Prose or our Electric Book Manager.

Jekyll is great at generating clean HTML in flexible ways, and has a big, active development community. It also includes kramdown and Sass, which are critical to creating flexible book designs quickly.

PrinceXML is the only software we use that isn’t open. While it’s proprietary, it’s an excellent implementation of the open standards for CSS Paged Media. In future, we hope to support other PDF renderers, too, such as:

Alternative tools

There are several digital-first book-publishing systems around. Some are also based on markdown, like ours. Not all produce print, ebook and web editions. For example:

PressBooks is another superb, affordable service. It’s built on Wordpress, and takes a different approach technically.

The Coko Foundation provides Editoria built with their new PubSweet framework. If you’re a large organisation, especially in scholarly publishing, or have in-house developers, it’s worth checking out.