diff --git a/packages/docs/astro.config.mjs b/packages/docs/astro.config.mjs
index 1889938a..dadf7756 100644
--- a/packages/docs/astro.config.mjs
+++ b/packages/docs/astro.config.mjs
@@ -2,6 +2,7 @@ import mdx from "@astrojs/mdx";
 import starlight from "@astrojs/starlight";
 import sentryStarlightTheme, {
   monochromeCodeTheme,
+  sentryAgentMarkdown,
 } from "@sentry/starlight-theme";
 import { defineConfig } from 'astro/config';
 
@@ -104,13 +105,14 @@ export default defineConfig({
           href: "https://github.com/getsentry/warden",
         },
       ],
-      plugins: [sentryStarlightTheme()],
+      plugins: [sentryStarlightTheme(), sentryAgentMarkdown()],
     }),
     mdx(),
   ],
   markdown: {
     shikiConfig: {
       theme: monochromeCodeTheme,
+  sentryAgentMarkdown,
     },
   }
 });
diff --git a/packages/docs/package.json b/packages/docs/package.json
index 489e9ac8..cb02c79a 100644
--- a/packages/docs/package.json
+++ b/packages/docs/package.json
@@ -11,7 +11,7 @@
     "@sentry/warden": "workspace:*",
     "@astrojs/mdx": "^5.0.6",
     "@astrojs/starlight": "^0.39.2",
-    "@sentry/starlight-theme": "^0.5.0",
+    "@sentry/starlight-theme": "^0.6.0",
     "astro": "^6.3.5",
     "geist": "^1.5.1",
     "shiki": "^1.0.0",
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 992a27fc..7a80fde4 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -115,8 +115,8 @@ importers:
         specifier: ^0.39.2
         version: 0.39.2(astro@6.3.6(@types/node@25.0.10)(@vercel/functions@2.2.13(@aws-sdk/credential-provider-web-identity@3.972.38))(jiti@2.7.0)(rollup@4.57.0)(tsx@4.21.0)(yaml@2.8.3))(typescript@5.9.3)
       '@sentry/starlight-theme':
-        specifier: ^0.5.0
-        version: 0.5.0(@astrojs/starlight@0.39.2(astro@6.3.6(@types/node@25.0.10)(@vercel/functions@2.2.13(@aws-sdk/credential-provider-web-identity@3.972.38))(jiti@2.7.0)(rollup@4.57.0)(tsx@4.21.0)(yaml@2.8.3))(typescript@5.9.3))
+        specifier: ^0.6.0
+        version: 0.6.0(@astrojs/starlight@0.39.2(astro@6.3.6(@types/node@25.0.10)(@vercel/functions@2.2.13(@aws-sdk/credential-provider-web-identity@3.972.38))(jiti@2.7.0)(rollup@4.57.0)(tsx@4.21.0)(yaml@2.8.3))(typescript@5.9.3))
       '@sentry/warden':
         specifier: workspace:*
         version: link:../..
@@ -1792,8 +1792,8 @@ packages:
       '@opentelemetry/sdk-trace-base': ^1.30.1 || ^2.1.0
       '@opentelemetry/semantic-conventions': ^1.39.0
 
-  '@sentry/starlight-theme@0.5.0':
-    resolution: {integrity: sha512-3WUbb6Rk9CP6CCxaftG8Sykcgws5mN6rOftD6RoXbEI9Zh1kzL2w8ZxiLezKIOX23QnbiKVmt9WpI6yn+A5vPg==}
+  '@sentry/starlight-theme@0.6.0':
+    resolution: {integrity: sha512-olQRVtrN9nJWoVVWhxUqk3KVEBCXRF2xLq4Pkd2/eyfpfzJTzfxFbAI4Sg/GV11IK3fFwNviIyFUPQR6aHsfKA==}
     engines: {node: '>=22.12.0'}
     peerDependencies:
       '@astrojs/starlight': '>=0.39.0'
@@ -6159,11 +6159,12 @@ snapshots:
       '@opentelemetry/semantic-conventions': 1.39.0
       '@sentry/core': 10.38.0
 
-  '@sentry/starlight-theme@0.5.0(@astrojs/starlight@0.39.2(astro@6.3.6(@types/node@25.0.10)(@vercel/functions@2.2.13(@aws-sdk/credential-provider-web-identity@3.972.38))(jiti@2.7.0)(rollup@4.57.0)(tsx@4.21.0)(yaml@2.8.3))(typescript@5.9.3))':
+  '@sentry/starlight-theme@0.6.0(@astrojs/starlight@0.39.2(astro@6.3.6(@types/node@25.0.10)(@vercel/functions@2.2.13(@aws-sdk/credential-provider-web-identity@3.972.38))(jiti@2.7.0)(rollup@4.57.0)(tsx@4.21.0)(yaml@2.8.3))(typescript@5.9.3))':
     dependencies:
       '@astrojs/starlight': 0.39.2(astro@6.3.6(@types/node@25.0.10)(@vercel/functions@2.2.13(@aws-sdk/credential-provider-web-identity@3.972.38))(jiti@2.7.0)(rollup@4.57.0)(tsx@4.21.0)(yaml@2.8.3))(typescript@5.9.3)
       '@fontsource-variable/rubik': 5.2.8
       '@fontsource/ibm-plex-mono': 5.2.7
+      ultrahtml: 1.6.0
 
   '@shikijs/core@1.29.2':
     dependencies: