Giving up on Read the Docs, reStructuredText and Sphinx

  1. Different formatting for headers, sections, and paragraphs (unlike different number of hashes or equals in Asciidoc or Markdown)
  2. Internal and external references (links) with weird syntax of two backticks followed by underscore
  3. Double backticks for inline code formatting
  4. Tips, code-blocks and similar blocks indented
  5. …and few others I’m hoping to forget pretty soon
  1. Asciidoc (or at the very least Markdown)
  2. GitHub integration
  3. GitBook theme
  4. Writing experience similar to Medium (or Leanpub)

IT Freelancer for Apache Spark, Delta Lake, Apache Kafka, Kafka Streams

Love podcasts or audiobooks? Learn on the go with our new app.

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store
Jacek Laskowski

Jacek Laskowski

IT Freelancer for Apache Spark, Delta Lake, Apache Kafka, Kafka Streams

More from Medium

How Asynchronous Communication Helps Remote Workers Boost Productivity

Asynchronous Communication

Choose your 8 Hours wisely

Core Skills of a Technical Business Analyst

Everything You Need to Know About a Hosted LMS & How To Choose One