diff --git a/docs/conf.py b/docs/conf.py
index 72ba74ed..73bf624e 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -80,7 +80,7 @@
     "sphinx.ext.napoleon",
     "sphinx_plotly_directive",
     "sphinx_rtd_theme",
-    "m2r2",
+    "sphinx_mdinclude",
     "sphinx_gallery.gen_gallery",
     "sphinxcontrib.mermaid",
 ]
diff --git a/docs/requirements.txt b/docs/requirements.txt
index 570bdfc7..ab29d7ef 100644
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -3,7 +3,7 @@
 # under `install_requires` in `setup.cfg` is also listed here!
 sphinx!=5.1.0
 sphinx_rtd_theme
-m2r2
+sphinx-mdinclude
 myst_parser
 scipy
 numpy>=1.20