diff --git a/docs/conf.py b/docs/conf.py
index c32af9c03..aa0c4b160 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -41,7 +41,7 @@
     "sphinx.ext.todo",
     "sphinx.ext.coverage",
     "rfc",
-    "m2r",
+    "sphinx_mdinclude",
     "sphinx_rtd_theme",
 ]
 
diff --git a/docs/requirements.txt b/docs/requirements.txt
index b47039487..b5550e503 100644
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -1,7 +1,6 @@
 Django
 oauthlib>=3.1.0
-m2r>=0.2.1
-mistune<2
-sphinx==7.2.6
-sphinx-rtd-theme==1.3.0
+sphinx_mdinclude
+sphinx>=7.2.6
+sphinx-rtd-theme>=1.3.0
 -e .
diff --git a/tox.ini b/tox.ini
index ba97bd113..ff1626728 100644
--- a/tox.ini
+++ b/tox.ini
@@ -91,8 +91,7 @@ deps =
     Jinja2<3.1
     sphinx<3
     oauthlib>=3.1.0
-    m2r>=0.2.1
-    mistune<2
+    sphinx_mdinclude
     sphinx-rtd-theme
     livedocs: sphinx-autobuild
     jwcrypto