To see how these tools work in concert, consider a realistic workflow for a Python library called “CoolLib”:

This pipeline eliminates manual drudgery and guarantees consistency.

While Sphinx is great for hierarchical documentation, static site generators (SSGs) use RST to build blogs and simple websites.

  • Nikola:

    • The myst-parser tool allows you to write Markdown files while using Sphinx cross-referencing roles (like doc). It is technically a tool for those who want the power of Sphinx but the simplicity of Markdown syntax.