diff --git a/docusaurus.config.js b/docusaurus.config.js
index 4a2adc552..3cab0ed2d 100644
--- a/docusaurus.config.js
+++ b/docusaurus.config.js
@@ -13,8 +13,12 @@ module.exports = {
   favicon: 'img/favicon.ico',
   onBrokenLinks: 'throw',
   onBrokenAnchors: 'throw',
-  onBrokenMarkdownLinks: 'throw',
   onDuplicateRoutes: 'warn',
+  markdown: {
+    hooks: {
+      onBrokenMarkdownLinks: 'throw',
+    },
+  },
   customFields: {
     image: 'https://www.okteto.com/docs/okteto-meta-image.png',
   },