doc: Allow for markdown files in documentation.

doc/conf.py

@@ -39,6 +39,7 @@ extensions = [
     'sphinx_copybutton',
     'sphinx.ext.autosummary',
     'sphinx.ext.napoleon',
+    'myst_parser',
 ]
 
 # Add any paths that contain templates here, relative to this directory.
@@ -48,7 +49,10 @@ templates_path = ['_templates']
 # You can specify multiple suffix as a list of string:
 #
 # source_suffix = ['.rst', '.md']
-source_suffix = '.rst'
+source_suffix = {
+    '.rst': 'restructuredtext',
+    '.md': 'markdown',
+}
 
 # The master toctree document.
 master_doc = 'index'

requirements_documentation.txt

@@ -4,3 +4,4 @@ nbsphinx-link
 sphinx_copybutton
 pydata_sphinx_theme
 #docutils=0.20
+myst-parser