Chapter 1. Join the Publishing Revolution

This is where I like to write!

Thank you for your interest in Atlas! Atlas is a wiki-like, git-managed authoring platform for creating books. If you haven’t already, you may want to check out the getting started video for a quick introduction to Atlas.

Some of the features of Atlas are as follows:

Simple markup
Atlas supports AsciiDoc and, for simpler projects, Markdown.
Git backend
If you have a book, you have a git repository and all of the power and convenience that comes with using git version control.
Easy book, ebook, and web builds
Atlas lets you build your project in four formats at any time: Mobi (for the Kindle), EPUB (for most other ebook platforms), PDF (for print), and HTML (for the web). Atlas also gives you tools to debug your ebook formats so that you can identify and fix problems quickly.
An invitation system
Add collaborators to your project at any time by simply sending an invite.
Flexible writing options
You can write directly within Atlas, but if writing in a web browser is not for you, no problem. Just use git to clone your book to a local machine and write in the text editor of your choice.

How It Works

  1. Receive an invite from an O’Reilly editor or another author and create an account.
  2. Write in AsciiDoc, an open source text format developed by Stuart Rackham. Each time you save a file, it will be logged into a git repository, so it’s always under version control.
  3. When you’re ready, build your book. Atlas interfaces with O’Reilly’s publishing toolchain, generating PDF, EPUB, and Mobi files for you on the fly. Theebook files look just like those for sale on

Why bother with this, you ask? We’re trying to create an appealing authoring process that will get you writing as quickly as possible.

Start Writing Today

We’re just getting started with Atlas, and you can play a role in determining future development by using the platform to write your book. If you’re willing to use Atlas, we ask that you:

  • Write in AsciiDoc, which is the preferred formats for Atlas.
  • Provide feedback. Atlas is currently in beta testing, and we need to hear from you to take the platform to the next level. To submit feedback, simply click on the Feedback tab within Atlas and create an Issue. You will need a GitHub account to create an Issue. If you’re not able or willing to provide feedback, Atlas might not be right for you at this time.

If the above sounds good to you, then you’re the perfect candidate to work in Atlas. We’re eager to help you get started. Let’s revolutionize publishing together!