Problem: The default RtD template uses reStructuredText

[julianpistorius]

Should we migrate to Markdown?

[julianpistorius]

• https://myst-parser.readthedocs.io/
• https://www.sphinx-doc.org/en/master/usage/markdown.html
• https://rst-to-myst.readthedocs.io/en/latest/index.html
• https://mystmd.org/guide/website-templates

[ejaffe-osc]

https://sphinx-tutorial.readthedocs.io/step-1/#
https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html#rst-primer

[ejaffe-osc]

Sounds like rst is more powerful, with steeper learning curve, but doesn't look all that complicated to me, as someone who knows neither markdown nor rst that well. Then again, I have latex experience, so pretty much anything looks easier than that haha