diff --git a/.eleventy.js b/.eleventy.js
index 45a962c..c7f997f 100644
--- a/.eleventy.js
+++ b/.eleventy.js
@@ -40,6 +40,7 @@ module.exports = function(conf) {
             .use(require('markdown-it-attrs'))
             .use(require('markdown-it-anchor'), { tabIndex: false })
             .use(require('markdown-it-github-alerts'))
+            .use(require('markdown-it-mermaid-plugin'))
     );
 
     conf.setLiquidOptions({
diff --git a/_includes/head.html b/_includes/head.html
index 51b107e..bf94c74 100644
--- a/_includes/head.html
+++ b/_includes/head.html
@@ -15,4 +15,10 @@
 
   <script src="https://cdn.jsdelivr.net/npm/anchor-js@3.2/anchor.min.js" type="text/javascript"></script>
   <script src="https://cdn.jsdelivr.net/npm/alpinejs@2/dist/alpine.min.js" type="text/javascript" defer></script>
+  {% if mermaid %}
+  <script type="module">
+    import mermaid from 'https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.esm.min.mjs';
+    mermaid.initialize({ startOnLoad: true });
+  </script>
+  {% endif %}
 </head>
diff --git a/package-lock.json b/package-lock.json
index 8bd220f..78a65db 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -20,6 +20,7 @@
         "markdown-it-anchor": "^10.0.0",
         "markdown-it-attrs": "^5.0.1",
         "markdown-it-github-alerts": "~0.3.2",
+        "markdown-it-mermaid-plugin": "^0.1.0",
         "sass": "^1.105.2",
         "string-strip-html": "~8.5.0"
       }
@@ -1584,6 +1585,12 @@
         "markdown-it": ">= 13.0.0"
       }
     },
+    "node_modules/markdown-it-mermaid-plugin": {
+      "version": "0.1.0",
+      "resolved": "https://registry.npmjs.org/markdown-it-mermaid-plugin/-/markdown-it-mermaid-plugin-0.1.0.tgz",
+      "integrity": "sha512-e5+BqzHA/P9rGLnryaLricGeQRnWkBKlfPdj1K8y5g7pZaIxQ6CtsDcxCqJ78aO7lmt0dLFI60wM0rq+D9V5YQ==",
+      "license": "MIT"
+    },
     "node_modules/markdown-it/node_modules/argparse": {
       "version": "3.0.3",
       "resolved": "https://registry.npmjs.org/argparse/-/argparse-3.0.3.tgz",
diff --git a/package.json b/package.json
index 4c11d76..6600f78 100644
--- a/package.json
+++ b/package.json
@@ -30,7 +30,11 @@
     "markdown-it-anchor": "^10.0.0",
     "markdown-it-attrs": "^5.0.1",
     "markdown-it-github-alerts": "~0.3.2",
+    "markdown-it-mermaid-plugin": "^0.1.0",
     "sass": "^1.105.2",
     "string-strip-html": "~8.5.0"
+  },
+  "allowScripts": {
+    "@parcel/watcher@2.6.0": true
   }
 }