diff --git a/pyproject.toml b/pyproject.toml
index 0ca3aeb13..0b9bedf2c 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -48,7 +48,7 @@ docs = [
     "sphinx-book-theme~=1.0",
     "sphinx-autodoc-typehints>=2,<4",
     "sphinxcontrib-autoyaml~=1.0",
-    "sphinxcontrib.mermaid~=1.0",
+    "sphinxcontrib.mermaid>=1,<3",
     "bokeh~=3.7",
     "ruamel.yaml~=0.18.0",
 ]