From 99ce8853286b42523e32591ff2a7bb7721b60aa0 Mon Sep 17 00:00:00 2001
From: Sebastian <sebastian.danielsson@proton.me>
Date: Sun, 15 Feb 2026 17:36:21 +0100
Subject: [PATCH] fix: move onBrokenMarkdownLinks config in
 docusaurus.config.ts to the new location

Fixes the following Docusaurus warning during build.
The `siteConfig.onBrokenMarkdownLinks` config option is deprecated and will be removed in Docusaurus v4.
Please migrate and move this option to `siteConfig.markdown.hooks.onBrokenMarkdownLinks` instead.

Signed-off-by: Sebastian <sebastian.danielsson@proton.me>
---
 microsite/docusaurus.config.ts | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/microsite/docusaurus.config.ts b/microsite/docusaurus.config.ts
index f591bb24d1..ce75a2e063 100644
--- a/microsite/docusaurus.config.ts
+++ b/microsite/docusaurus.config.ts
@@ -86,7 +86,6 @@ const config: Config = {
     repoUrl: 'https://github.com/backstage/backstage',
   },
   onBrokenLinks: 'log',
-  onBrokenMarkdownLinks: 'log',
   future: {
     v4: {
       removeLegacyPostBuildHeadAttribute: true,
@@ -169,6 +168,9 @@ const config: Config = {
       return removeHtmlComments(fileContent);
     },
     format: 'detect',
+    hooks: {
+      onBrokenMarkdownLinks: 'log',
+    },
   },
   plugins: [
     'docusaurus-plugin-sass',