diff --git a/docs_requirements.txt b/docs_requirements.txt
index 89890223d..aab58f2bf 100644
--- a/docs_requirements.txt
+++ b/docs_requirements.txt
@@ -14,3 +14,4 @@ mkdocstrings
 mkdocstrings-python
 mkdocs-table-reader-plugin
 numpy==1.26.4
+mkdocs-mermaid2-plugin
diff --git a/mkdocs.yml b/mkdocs.yml
index c81fb5779..196cd115d 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -44,6 +44,7 @@ plugins:
      # custom_templates: templates
   - search
   - table-reader
+  - mermaid2
 
 nav:
   - Home: index.md
@@ -85,3 +86,9 @@ markdown_extensions:
   - pymdownx.keys
   - pymdownx.mark
   - pymdownx.tilde
+  - pymdownx.superfences:
+      custom_fences:
+        - name: mermaid
+          class: mermaid
+          format: !!python/name:mermaid2.fence_mermaid_custom
+