fix(links): decode percent-encoding when resolving markdown links

Hand-written `.md` links sometimes URL-encode spaces (e.g.
`../My%20Page.md`). The link rewriter keyed the link map on raw relative
paths (literal spaces), so encoded links failed the lookup and were left
pointing at a non-existent `.md` URL. Decode the link path with
Uri.UnescapeDataString before normalizing so both literal-space and
`%20`-encoded links resolve to the correct (optionally slugified) target.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: Netdocs

src/Netdocs.Core/Markdown/DocumentRenderer.cs

@@ -111,6 +111,10 @@ private void RewriteMarkdownLinks(MarkdownDocument document, string currentRelat
             !path.EndsWith(".markdown", StringComparison.OrdinalIgnoreCase))
             return null;
 
+        // Decode percent-encoding (e.g. hand-written `%20` for spaces) so the link path
+        // matches the raw relative paths used as map keys.
+        path = Uri.UnescapeDataString(path);
+
         var currentDir = Path.GetDirectoryName(currentRelativePath.Replace('\\', '/'))?.Replace('\\', '/') ?? "";
         var combined = currentDir.Length == 0 ? path : currentDir + "/" + path;
         var normalized = NormalizeRelative(combined);

tests/Netdocs.Core.Tests/CoreTests.cs

@@ -368,4 +368,30 @@ public void MarkdownLinks_AreRewrittenRelativeToPage_ForBasePathSafety()
         Assert.Contains("href=\"../getting-started/quickstart/\"", nested.HtmlContent);
         Assert.DoesNotContain("href=\"/reference/cli/\"", nested.HtmlContent);
     }
+
+    [Fact]
+    public void MarkdownLinks_WithPercentEncodedSpaces_ResolveToSlugifiedTarget()
+    {
+        // A hand-written `.md` link may URL-encode spaces (`%20`). The rewriter must decode
+        // it so it matches the raw relative path used as the link-map key, and rewrite it to
+        // the (possibly slugified) target URL.
+        var site = new SiteContext { Config = new SiteConfig(), Options = new BuildOptions(), LoggerFactory = NullLoggerFactory.Instance };
+        var pipeline = MarkdownPipelineFactory.Build(site, []);
+        var map = new Dictionary<string, string>(StringComparer.OrdinalIgnoreCase)
+        {
+            ["cluster/Openshift Registry Setup.md"] = "cluster/openshift-registry-setup/",
+        };
+
+        var page = new Page
+        {
+            SourcePath = "cluster/deploy/index.md",
+            RelativePath = "cluster/deploy/index.md",
+            Url = "cluster/deploy/",
+            ProcessedMarkdown = "See [reg](../Openshift%20Registry%20Setup.md).",
+        };
+        new DocumentRenderer(pipeline, map).Render(page);
+
+        Assert.Contains("href=\"../../cluster/openshift-registry-setup/\"", page.HtmlContent);
+        Assert.DoesNotContain("%20", page.HtmlContent);
+    }
 }