diff --git a/docs/developer/docusaurus.config.ts b/docs/developer/docusaurus.config.ts
index a5c2a47..f7c94b5 100644
--- a/docs/developer/docusaurus.config.ts
+++ b/docs/developer/docusaurus.config.ts
@@ -26,6 +26,9 @@ const config: Config = {
     hooks: {
       onBrokenMarkdownLinks: 'warn',
     },
+    mdx1Compat: {
+      admonitions: true,
+    },
   },
 
   themes: ['@docusaurus/theme-mermaid'],
diff --git a/docs/user/docusaurus.config.ts b/docs/user/docusaurus.config.ts
index 6fe0023..4388bbb 100644
--- a/docs/user/docusaurus.config.ts
+++ b/docs/user/docusaurus.config.ts
@@ -26,6 +26,9 @@ const config: Config = {
     hooks: {
       onBrokenMarkdownLinks: 'warn',
     },
+    mdx1Compat: {
+      admonitions: true,
+    },
   },
 
   themes: ['@docusaurus/theme-mermaid'],