diff --git a/docs/Pipfile b/docs/Pipfile
index 3f2c19f..f138bc1 100644
--- a/docs/Pipfile
+++ b/docs/Pipfile
@@ -6,6 +6,7 @@ name = "pypi"
 [packages]
 sphinx = "*"
 myst-parser = "*"
+sphinxcontrib-mermaid = "*"
 revitron-sphinx-theme = {git = "https://github.com/revitron/revitron-sphinx-theme.git", ref = "master"}
 linkify-it-py = "*"
 
diff --git a/docs/conf.py b/docs/conf.py
index 1e525fb..b7ad9c8 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -18,12 +18,15 @@
 
 extensions = [
     'myst_parser',  # Markdown support
+    'sphinxcontrib.mermaid',  # Mermaid diagram support
     'sphinx.ext.githubpages',  # Create .nojekyll file for GitHub Pages
     'sphinx.ext.intersphinx',  # Link to other projects' documentation
     'sphinx.ext.todo',  # Support for todo items
 ]
 
 # MyST-Parser configuration - enable all features
+myst_fence_as_directive = ["mermaid"]  # Render ```mermaid blocks as Mermaid diagrams
+
 myst_enable_extensions = [
     "amsmath",
     "colon_fence",