diff --git a/docusaurus.config.ts b/docusaurus.config.ts
index 198eb7d..ef7a6ad 100644
--- a/docusaurus.config.ts
+++ b/docusaurus.config.ts
@@ -32,6 +32,9 @@ const config: Config = {
     // explicit heading IDs ({#anchor}) in many pages.
     mdx1Compat: {
       headingIds: true,
+      // Docs use the `:::danger Title` admonition syntax; v4 defaults would
+      // render the title as literal text.
+      admonitions: true,
     },
   },