You can use markdown by adding the md suffix to your conf.py and myst_parser [1] to your sphinx extensions.

They are starting to work towards full sphinx functionality in myst markdown, too.

[1] https://myst-parser.readthedocs.io/en/latest/intro.html [1] https://executablebooks.org/en/latest/blog/2023/new-project-...