From dcf01e65796ec25c462ab30ac5ec2f038067aafc Mon Sep 17 00:00:00 2001
From: sebastien <lorber.sebastien@gmail.com>
Date: Fri, 27 Feb 2026 19:02:57 +0100
Subject: [PATCH] fix write-heading-ids CLI

---
 .../docusaurus/src/commands/writeHeadingIds.ts   | 16 ++++++++++------
 1 file changed, 10 insertions(+), 6 deletions(-)

diff --git a/packages/docusaurus/src/commands/writeHeadingIds.ts b/packages/docusaurus/src/commands/writeHeadingIds.ts
index 3963270dc582..f35a36cf2117 100644
--- a/packages/docusaurus/src/commands/writeHeadingIds.ts
+++ b/packages/docusaurus/src/commands/writeHeadingIds.ts
@@ -47,12 +47,16 @@ export async function writeHeadingIds(
 ): Promise<void> {
   const siteDir = await fs.realpath(siteDirParam);
 
-  const markdownFiles = await safeGlobby(
-    files ?? (await getPathsToWatch(siteDir)),
-    {
-      expandDirectories: ['**/*.{md,mdx}'],
-    },
-  );
+  const patterns = files.length ? files : await getPathsToWatch(siteDir);
+
+  const markdownFiles = await safeGlobby(patterns, {
+    expandDirectories: ['**/*.{md,mdx}'],
+  });
+
+  if (markdownFiles.length === 0) {
+    logger.warn`No markdown files found in siteDir path=${siteDir} for patterns: ${patterns}`;
+    return;
+  }
 
   const result = await Promise.all(
     markdownFiles.map((p) => transformMarkdownFile(p, options)),