youtu.be
"Switching from Sphinx to Markdown" - Kattni (PyCon AU 2026)
For most of Python's history, the predominant option for documentation has been Sphinx and reStructuredText. However, a majority of other ecosystems have adopted Markdown. There are historical reasons for reStructuredText being a better choice, however, Markdown is now up to the task.
In this talk, you'll learn why Markdown is a better option for your project's documentation. You'll be