diff --git a/pyproject.toml b/pyproject.toml
index 73aaeec30..993beaeb2 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -59,13 +59,13 @@ dev = [
 ]
 testing = ["pytest >= 7.4.0, < 8.4.0", "pytest-cov", "coveralls"]
 docs = [
-    "mkdocs >= 1.6.1",
+    "mkdocs >= 1.6.1, < 2",
     "mkdocs-material >= 9.6.18",
-    "mkdocstrings >= 0.30.0",
+    "mkdocstrings >= 0.30.0, < 1.0.6",
     "mkdocstrings-python >= 1.17.0, <2.0",
     "mkdocs-exclude >= 1.0.2",
     "mike >= 2.1.3",
-    "pymdown-extensions >= 10.16.1",
+    "pymdown-extensions >= 10.16.1, < 12.2",
     "black >= 25.1.0",
     "mkdocs-jupyter >=0.25.1",
 ]