GitBook

The software that formatted what you're reading now.

After trying a couple hosted and self-hosted blogging solutions, I've settled on GitBook.com. GitBook itself is opensource software and gitbook.com provides a free or paid GitBook hosting service.

The thing that's best about GitBook is the way you can organize a structured outline of the site's contents. The other killer feature is it's ability to do code-related formatting, including:

  • an editor almost as nice as Medium (and more featured)

  • contents/outline with nesting and collapsing

  • code blocks with language-specific highlighting

  • tabs (e.g. to provide examples in different languages, platforms, etc.)

This is an example in case one.
  • API documentation form

/v1/cakes/:id

GET https://api.acme.com/v1/cakes/:id

Retrieves the details for a single cake by its id.

Path Parameters

NameTypeDescription

include_customer

boolean

Include customer details when true.

  • variants (e.g. different spoken language versions of a page)

  • integrations: Slack, GitHub, Google Analytics, Intercom

  • versioning of edits (as in why it's called 'git'book)

  • the free gitbook.com service also allows using a custom domain name

Last updated