diff --git a/docs/architecture/overview.md b/docs/architecture/overview.md
index bf724a6..8a369d8 100644
--- a/docs/architecture/overview.md
+++ b/docs/architecture/overview.md
@@ -30,10 +30,12 @@ compose a bespoke proxy server from the same primitives.
 - **AI Agents**: Proxy for AI agents
 - **Security Gateway**: Guardrails, Network Policy
 
-:::tip Interactive Diagram
+:::tip[Interactive Diagram]
+
 See the [interactive architecture diagram](pathname:///architecture/diagram.html)
 for a visual overview of crate dependencies, filter
 categories, and request flow.
+
 :::
 
 ## System Architecture
diff --git a/docs/architecture/system-design.md b/docs/architecture/system-design.md
index 0dcaf55..a2c756a 100644
--- a/docs/architecture/system-design.md
+++ b/docs/architecture/system-design.md
@@ -35,10 +35,12 @@ compose a bespoke proxy server from the same primitives.
 - **AI Agents**: Proxy for AI agents
 - **Security Gateway**: Guardrails, Network Policy
 
-:::tip Interactive Diagram
+:::tip[Interactive Diagram]
+
 See the [interactive architecture diagram](pathname:///architecture/diagram.html)
 for a visual overview of crate dependencies, filter
 categories, and request flow.
+
 :::
 
 ## System Architecture