diff --git a/docs/docusaurus.config.ts b/docs/docusaurus.config.ts
index 419269cca..17f7cfe3f 100644
--- a/docs/docusaurus.config.ts
+++ b/docs/docusaurus.config.ts
@@ -19,7 +19,11 @@ const config: Config = {
   projectName: 'endive', // Usually your repo name.
 
   onBrokenLinks: 'warn', // TODO: fixme when everything is ready: 'throw',
-  onBrokenMarkdownLinks: 'warn',
+  markdown: {
+    hooks: {
+      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