Handle crosslinks

Author: theletterf

src/Elastic.Markdown/Myst/Renderers/LlmMarkdown/LlmBlockRenderers.cs

@@ -107,15 +107,24 @@ private static string ConvertToMarkdownUrl(string url)
 		if (markdownPath.StartsWith("docs/", StringComparison.Ordinal))
 			markdownPath = markdownPath.Substring(5);
 
-		// Convert directory URLs to .md files
+		// Convert directory URLs to .md files, but don't convert image files
 		if (markdownPath.EndsWith('/'))
 			markdownPath = markdownPath.TrimEnd('/') + ".md";
-		else if (!markdownPath.EndsWith(".md", StringComparison.Ordinal))
+		else if (!markdownPath.EndsWith(".md", StringComparison.Ordinal) && !IsImageFile(markdownPath))
 			markdownPath += ".md";
 
 		return $"/docs/{markdownPath}";
 	}
 
+	/// <summary>
+	/// Checks if a URL path points to an image file
+	/// </summary>
+	private static bool IsImageFile(string path)
+	{
+		var extension = Path.GetExtension(path).ToLowerInvariant();
+		return extension is ".png" or ".jpg" or ".jpeg" or ".gif" or ".svg" or ".webp" or ".bmp" or ".ico";
+	}
+
 }
 
 /// <summary>

src/Elastic.Markdown/Myst/Renderers/LlmMarkdown/LlmInlineRenderers.cs

@@ -32,7 +32,7 @@ protected override void Write(LlmMarkdownRenderer renderer, LinkInline obj)
 			renderer.WriteChildren(obj);
 			renderer.Writer.Write("](");
 			var url = obj.GetDynamicUrl?.Invoke() ?? obj.Url;
-			var absoluteUrl = LlmRenderingHelpers.MakeAbsoluteUrl(renderer, url);
+			var absoluteUrl = ProcessLinkUrl(renderer, obj, url);
 			renderer.Writer.Write(absoluteUrl ?? string.Empty);
 		}
 		if (!string.IsNullOrEmpty(obj.Title))
@@ -43,6 +43,43 @@ protected override void Write(LlmMarkdownRenderer renderer, LinkInline obj)
 		}
 		renderer.Writer.Write(")");
 	}
+
+	/// <summary>
+	/// Processes link URLs with special handling for crosslinks to ensure they get .md treatment
+	/// </summary>
+	private static string? ProcessLinkUrl(LlmMarkdownRenderer renderer, LinkInline obj, string? url)
+	{
+		// Check if this is a crosslink (similar to HtmxLinkInlineRenderer)
+		var isCrossLink = (obj.GetData("isCrossLink") as bool?) == true;
+
+		// Also check if this is a resolved crosslink to Elastic docs by URL pattern
+		// This handles cases where crosslinks have been resolved but lost their metadata
+		var isElasticDocsUrl = !string.IsNullOrEmpty(url) &&
+							  url.StartsWith("https://www.elastic.co/docs/", StringComparison.Ordinal);
+
+		if ((isCrossLink || isElasticDocsUrl) && !string.IsNullOrEmpty(url))
+		{
+			// For crosslinks that resolve to documentation URLs, use MakeAbsoluteMarkdownUrl
+			// to ensure they get the .md treatment
+			if (url.Contains("/docs/", StringComparison.Ordinal))
+			{
+				// Extract the docs path from the resolved URL
+				var uri = Uri.TryCreate(url, UriKind.Absolute, out var parsedUri) ? parsedUri : null;
+				if (uri != null && renderer.BuildContext.CanonicalBaseUrl != null)
+				{
+					var path = uri.AbsolutePath;
+					if (path.StartsWith("/docs/", StringComparison.Ordinal))
+					{
+						return LlmRenderingHelpers.MakeAbsoluteMarkdownUrl(renderer.BuildContext.CanonicalBaseUrl, path);
+					}
+				}
+			}
+		}
+
+		// For regular links, use the standard absolute URL conversion
+		return LlmRenderingHelpers.MakeAbsoluteUrl(renderer, url);
+	}
+
 }
 
 public class LlmEmphasisInlineRenderer : MarkdownObjectRenderer<LlmMarkdownRenderer, EmphasisInline>