diff --git a/docs/docusaurus.config.js b/docs/docusaurus.config.js
index 4a62221da..b26e4571c 100644
--- a/docs/docusaurus.config.js
+++ b/docs/docusaurus.config.js
@@ -24,7 +24,6 @@ const config = {
     projectName: 'architecture-as-code', // 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
@@ -34,6 +33,12 @@ const config = {
         locales: ['en'],
     },
 
+    markdown: {
+        hooks: {
+            onBrokenMarkdownLinks: 'warn'
+        }
+    },
+
     presets: [
         [
             'classic',