From 6315324902db28ca5bc92ffb749d1dcf3ff7befe Mon Sep 17 00:00:00 2001 From: Philpax Date: Fri, 27 Mar 2026 17:03:34 +0100 Subject: [PATCH] fix: always use .md extension in links for Docusaurus compatibility Without .md extensions, Docusaurus passes links through as raw URL paths. When browsers resolve these relative URLs against pages served with trailing slashes, the relative path goes one level too few, producing duplicated namespace segments in the resolved URL. Always using .md extensions tells Docusaurus to resolve links as file references at build time, which is immune to trailing slash behavior. --- Program.cs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Program.cs b/Program.cs index ad26b52..1a2eb1d 100644 --- a/Program.cs +++ b/Program.cs @@ -170,7 +170,7 @@ string Link(string uid, bool linkFromGroupedType, bool nameOnly = false, bool li var name = nameOnly ? reference.Name : reference.FullName; var filename = config.UseUidFilename ? reference.Uid : reference.Name; var dots = linkFromIndex ? "./" : linkFromGroupedType ? "../../" : "../"; - var extension = linkFromIndex ? ".md" : ""; + var extension = ".md"; if (reference.Type is "Class" or "Interface" or "Enum" or "Struct" or "Delegate") { if (NamespaceHasTypeGrouping(reference.Namespace))