fix: render Mermaid diagrams

Author: SamKuler

mkdocs.yml

@@ -80,7 +80,11 @@ markdown_extensions:
   - pymdownx.highlight:
       anchor_linenums: true
   - pymdownx.inlinehilite
-  - pymdownx.superfences
+  - pymdownx.superfences:
+      custom_fences:
+        - name: mermaid
+          class: mermaid
+          format: !!python/name:pymdownx.superfences.fence_code_format
   - pymdownx.tasklist:
       custom_checkbox: true
 

tests/test_rendering_contract.py

@@ -44,6 +44,18 @@ def test_navigation_uses_a_dedicated_high_contrast_palette(self):
         self.assertIn("background-color: var(--ae-nav-bg);", css)
         self.assertIn("color: var(--ae-nav-fg);", css)
 
+    def test_mermaid_fences_use_material_native_renderer(self):
+        config = (ROOT / "mkdocs.yml").read_text(encoding="utf-8")
+
+        self.assertIn("- pymdownx.superfences:", config)
+        self.assertIn("custom_fences:", config)
+        self.assertIn("- name: mermaid", config)
+        self.assertIn("class: mermaid", config)
+        self.assertIn(
+            "format: !!python/name:pymdownx.superfences.fence_code_format",
+            config,
+        )
+
 
 if __name__ == "__main__":
     unittest.main()