Markdown to reStructuredText

Markdown vs reStructuredText (RST)

reStructuredText (RST) is the native documentation format for the Python ecosystem. Tools like Sphinx (the Python documentation builder) and Read the Docs natively parse RST, making it the standard for Python package docs, PEPs, and open-source project documentation. While Markdown is simpler and more widely recognized in the general web development world, RST offers richer cross-referencing, directives, and semantic markup that Sphinx exploits for navigation, indexing, and API docs. Use this converter when migrating a project from GitHub README-style Markdown to a full Sphinx documentation setup. Headings use underline characters (=, -,~), links use the `text <url>`_ syntax, and code blocks use the .. code-block:: directive.