Convert from ReST to MyST
MyST allows one to use Markdown syntax instead of reStructuredText for the documentation source.
There is an automated tool to convert, but there are some caveats on what can be converted: https://rst-to-myst.readthedocs.io/en/latest/usage.html#how-it-works
LibCEED successfully did this: https://github.com/CEED/libCEED/tree/main/doc/sphinx/source
Edited by Patrick Sanan