diff --git a/pyproject.toml b/pyproject.toml
index 6015b05..da9d986 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -112,7 +112,7 @@ optional-dependencies.docs = [
   "sphinx<9",
   "sphinx-copybutton",
   "sphinx-design-elements<1",
-  "sphinxcontrib-mermaid<1",
+  "sphinxcontrib-mermaid<2",
   "sphinxext-opengraph<1",
 ]
 optional-dependencies.release = [