Fix inline code in left navigation and h1 rendering

Author: reakaleek

docs/contribute/locally.md

@@ -1,4 +1,4 @@
-# Contribute locally
+# Contribute locally `This is a code block`
 
 Follow these steps to contribute to Elastic docs.
 * [Step 1: Install `docs-builder`](#step-one)
@@ -116,4 +116,4 @@ Open a PR. Good luck.
 
 ## Step 5: View on elastic.co/docs
 
-soon...
+soon...

src/Elastic.Markdown/Helpers/TitleSanitizer.cs

@@ -0,0 +1,8 @@
+namespace Elastic.Markdown.Helpers;
+
+public static class TitleSanitizer
+{
+    // Removes markdown formatting from the title and returns only the text
+    // Currently, only support 'bold' and 'code' formatting
+	public static string Sanitize(string title) => title.Replace("`", "").Replace("*", "");
+}

src/Elastic.Markdown/IO/MarkdownFile.cs

@@ -46,7 +46,10 @@ public DocumentationGroup? Parent
 	public string? Title { get; private set; }
 	public string? NavigationTitle
 	{
-		get => !string.IsNullOrEmpty(_navigationTitle) ? _navigationTitle : Title;
+		get {
+			var title = !string.IsNullOrEmpty(_navigationTitle) ? _navigationTitle : Title;
+			return string.IsNullOrEmpty(title) ? null : TitleSanitizer.Sanitize(title);
+		}
 		private set => _navigationTitle = value;
 	}
 
@@ -159,7 +162,7 @@ private void ReadDocumentInstructions(MarkdownDocument document)
 			.Select(h => (h.GetData("header") as string, h.GetData("anchor") as string))
 			.Select(h => new PageTocItem
 			{
-				Heading = h.Item1!.Replace("`", "").Replace("*", ""),
+				Heading = TitleSanitizer.Sanitize(h.Item1!),
 				Slug = _slugHelper.GenerateSlug(h.Item2 ?? h.Item1)
 			})
 			.ToList();

src/Elastic.Markdown/Slices/Index.cshtml

@@ -1,9 +1,10 @@
+@using Markdig
 @inherits RazorSliceHttpResult<IndexViewModel>
 @implements IUsesLayout<Elastic.Markdown.Slices._Layout, LayoutViewModel>
 @functions {
 	public LayoutViewModel LayoutModel => new()
 	{
-		Title = $"Elastic Documentation: {Model.Title}",
+		Title = $"Elastic Documentation: {Model.Title ?? "Untitled"}",
 		PageTocItems = Model.PageTocItems,
 		Tree = Model.Tree,
 		CurrentDocument = Model.CurrentDocument,
@@ -16,7 +17,7 @@
 	};
 }
 <section id="elastic-docs-v3">
-	<h1>@(Model.Title)</h1>
+	@(new HtmlString(Markdown.ToHtml("# " + Model.Title)))
 	@if (Model.Applies is not null)
 	{
 		await RenderPartialAsync(Applies.Create(Model.Applies));