Use MyST for parsing Markdown files in documentation

Author: mfasi

.github/workflows/deploy_docs.yml

@@ -10,8 +10,7 @@ jobs:
 
       - name: Install and Build
         run: |
-          sudo apt install -y doxygen graphviz
-          pip install sphinx sphinx_rtd_theme breathe exhale m2r2
+          sudo apt install -y doxygen graphviz python3-sphinx python3-breathe python3-sphinx-rtd-theme python3-breathe python3-exhale python3-myst-parser
           make docs
 
       - name: Deploy

docs/source/conf.py

@@ -34,7 +34,7 @@
     'sphinx.ext.githubpages',
     'breathe',
     'exhale',
-    'm2r2',
+    'myst_parser',
 ]
 
 # Setup the breathe extension

docs/source/readme.rst

@@ -1 +1,2 @@
-.. mdinclude:: ../../README.md
+.. include:: ../../README.md
+   :parser: myst_parser.docutils_