The Python Papers

The Python Papers

Share this post

The Python Papers
The Python Papers
Creating a Docs Website with Sphinx and Markdown

Creating a Docs Website with Sphinx and Markdown

Mike Driscoll's avatar
Mike Driscoll
Jun 30, 2025
∙ Paid
1

Share this post

The Python Papers
The Python Papers
Creating a Docs Website with Sphinx and Markdown
Share

Sphinx is a Python-based documentation builder. The Python documentation is written using Sphinx. The Sphinx project supports using ReStructuredText and Markdown, or a mixture of the two. Each page of your documentation or website must be written using one of those two formats.

The original Python 101 website uses an old version of Sphinx, for example.

In…

Keep reading with a 7-day free trial

Subscribe to The Python Papers to keep reading this post and get 7 days of free access to the full post archives.

Already a paid subscriber? Sign in
© 2025 Mike Driscoll
Privacy ∙ Terms ∙ Collection notice
Start writingGet the app
Substack is the home for great culture

Share