diff --git a/doc/conf.py b/doc/conf.py
index 6df820a6c8f1091a602c9d334f81d1d01d361135..1415844cea31b72d11f0b4fbf09733dc0660b7ce 100644
--- a/doc/conf.py
+++ b/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'
diff --git a/requirements_documentation.txt b/requirements_documentation.txt
index a23af6029870f2a607ff8421c6f83a434c96c723..928f90961b60fd8843d50567caedddb2c271c14f 100644
--- a/requirements_documentation.txt
+++ b/requirements_documentation.txt
@@ -4,3 +4,4 @@ nbsphinx-link
 sphinx_copybutton
 pydata_sphinx_theme
 #docutils=0.20
+myst-parser