Warn about links with template expressions

docs/source/syntax/links.md

@@ -32,6 +32,16 @@ I link to the [Inline link](#inline-link) heading above.
 I link to the [Notes](tables.md#notes) heading on the [Tables](tables.md) page.
 ```
 
+## Cross Links
+
+Cross links are links that point to a different docset.
+
+```markdown
+[Cross link](kibana://cross-link.md)
+```
+
+The syntax is `<scheme>://<path>`, where <scheme> is the repository name and <path> is the path to the file.
+
 ## Heading anchors
 
 Headings will automatically create anchor links in the resulting html. 

src/Elastic.Markdown/Myst/InlineParsers/DiagnosticLinkInlineParser.cs

@@ -62,6 +62,12 @@ public override bool Match(InlineProcessor processor, ref StringSlice slice)
 			return match;
 		}
 
+		if (url.Contains("{{") || url.Contains("}}"))
+		{
+			processor.EmitWarning(line, column, length, "The url contains a template expression. Please do not use template expressions in links. See https://github.com/elastic/docs-builder/issues/182 for further information.");
+			return match;
+		}
+
 		var uri = Uri.TryCreate(url, UriKind.Absolute, out var u) ? u : null;
 
 		if (IsCrossLink(uri))

tests/Elastic.Markdown.Tests/Inline/InlineLinkTests.cs

@@ -173,3 +173,25 @@ public void EmitsCrossLink()
 		Collector.CrossLinks.Should().Contain("kibana://index.md");
 	}
 }
+
+public class LinksWithInterpolationWarning(ITestOutputHelper output) : LinkTestBase(output,
+	"""
+	[global search field]({{kibana-ref}}/introduction.html#kibana-navigation-search)
+	"""
+)
+{
+	[Fact]
+	public void GeneratesHtml() =>
+		// language=html
+		Html.Should().Contain(
+			"""<p><a href="%7B%7Bkibana-ref%7D%7D/introduction.html#kibana-navigation-search">global search field</a></p>"""
+		);
+
+	[Fact]
+	public void HasWarnings()
+	{
+		Collector.Diagnostics.Should().HaveCount(1);
+		Collector.Diagnostics.First().Severity.Should().Be(Diagnostics.Severity.Warning);
+		Collector.Diagnostics.First().Message.Should().Contain("The url contains a template expression. Please do not use template expressions in links. See https://github.com/elastic/docs-builder/issues/182 for further information.");
+	}
+}