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.

GitBook – The AI-native documentation platformgitbook.com

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.)

Case #1

This is an example in case one.

Case #2

• 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

Name	Type	Description
include_customer	boolean	Include customer details when true.

200

• 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