Static Sites with Sphinx and Markdown
Explore static site generation using Sphinx and Markdown in this 22-minute PyCon US talk. Learn how to leverage Sphinx, traditionally used for project documentation, for building entire websites. Discover the advantages of MyST, which brings full Markdown support to Sphinx, making it more accessible to those familiar with Markdown syntax. Compare Sphinx's features to other static site generators, including its rich linking capabilities and suitability for creating comprehensive knowledge bases. Follow along as the speaker demonstrates how to enable MyST for Markdown in Sphinx, configure the system, and utilize enhanced Markdown features like admonitions, toctree with options, and cross-referencing. Gain insights into customization options and explore the potential future developments of Sphinx for static site generation.