diff --git a/docusaurus.config.ts b/docusaurus.config.ts
index 8271c7101e..4aa3f0a979 100644
--- a/docusaurus.config.ts
+++ b/docusaurus.config.ts
@@ -65,7 +65,6 @@ const config: Config = {
   projectName: 'adcp', // Usually your repo name.
 
   onBrokenLinks: 'throw',
-  onBrokenMarkdownLinks: 'warn',
 
   // Even if you don't use internationalization, you can use this field to set
   // useful metadata like html lang. For example, if your site is Chinese, you
@@ -78,6 +77,9 @@ const config: Config = {
   themes: ['@docusaurus/theme-mermaid'],
   markdown: {
     mermaid: true,
+    hooks: {
+      onBrokenMarkdownLinks: 'warn',
+    },
   },
 
   plugins: [