minor adjustments

src/Docfx.Dotnet/DotnetApiCatalog.Page.cs

@@ -136,7 +136,7 @@ void Types(Func<INamedTypeSymbol, bool> predicate, string headingText)
 
             void Enum(INamedTypeSymbol type)
             {
-                writer.Heading(3, SymbolFormatter.GetName(symbol, SyntaxLanguage.CSharp));
+                writer.Heading(1, $"Enum {SymbolFormatter.GetName(symbol, SyntaxLanguage.CSharp)}");
 
                 writer.Facts(Facts().ToArray());
                 Summary(comment);

src/Docfx.Dotnet/PageWriter.cs

@@ -61,7 +61,7 @@ public override void Heading(int level, string title, string? id = null)
         _sb.Append($"{new string('#', level)} ");
         if (!string.IsNullOrEmpty(id))
             _sb.Append($"<a id=\"{id}\"></a>");
-        _sb.Append(title).AppendLine();
+        _sb.AppendLine(title).AppendLine();
     }
 
     public override void Facts(params Fact[] facts)
@@ -81,17 +81,17 @@ public override void List(ListDelimiter delimiter, params TextSpan[][] items)
         for (var i = 0; i < items.Length - 1; i++)
         {
             Text(items[i]);
-            _sb.Append(delimiter switch
+            _sb.AppendLine(delimiter switch
             {
                 ListDelimiter.LeftArrow => " \u2190 ",
                 ListDelimiter.Comma => ", ",
-                ListDelimiter.NewLine => Environment.NewLine,
+                ListDelimiter.NewLine => "  ",
                 _ => throw new NotSupportedException($"Unknown delimiter {delimiter}"),
             });
         }
 
         Text(items[^1]);
-        _sb.AppendLine();
+        _sb.AppendLine().AppendLine();
     }
 
     public override void Markdown(string markdown)

test/docfx.Snapshot.Tests/SamplesTest.SeedMarkdown/BuildFromAssembly.Class1.verified.md

@@ -1,20 +1,20 @@
 # Class Class1
 
-__Namespace:__ [BuildFromAssembly](BuildFromAssembly.md)  
-__Assembly:__ BuildFromAssembly.dll
+Namespace: [BuildFromAssembly](BuildFromAssembly.md)  
+Assembly: BuildFromAssembly.dll
 
 This is a test class.
 
 ```csharp
 public class Class1
 ```
 
-#### Inheritance
+###### Inheritance
 
 [object](https://learn.microsoft.com/dotnet/api/system.object) ← 
 [Class1](BuildFromAssembly.Class1.md)
 
-#### Inherited Members
+###### Inherited Members
 
 [object.GetType()](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
 [object.MemberwiseClone()](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
@@ -26,15 +26,15 @@ public class Class1
 
 ## Constructors
 
-### Class1()
+### <a id="BuildFromAssembly_Class1__ctor"></a>Class1()
 
 ```csharp
 public Class1()
 ```
 
 ## Methods
 
-### HelloWorld()
+### <a id="BuildFromAssembly_Class1_HelloWorld"></a>HelloWorld()
 
 Hello World.
 

test/docfx.Snapshot.Tests/SamplesTest.SeedMarkdown/BuildFromAssembly.verified.md

@@ -1,8 +1,9 @@
 # Namespace BuildFromAssembly
 
-## Classes
+### Classes
 
 [Class1](BuildFromAssembly.Class1.md)
 
 This is a test class.
 
+

test/docfx.Snapshot.Tests/SamplesTest.SeedMarkdown/BuildFromCSharpSourceCode.CSharp.verified.md

@@ -1,18 +1,17 @@
 # Class CSharp
 
-__Namespace:__ [BuildFromCSharpSourceCode](BuildFromCSharpSourceCode.md)  
-__Assembly:__ ?.dll
+Namespace: [BuildFromCSharpSourceCode](BuildFromCSharpSourceCode.md)
 
 ```csharp
 public class CSharp
 ```
 
-#### Inheritance
+###### Inheritance
 
 [object](https://learn.microsoft.com/dotnet/api/system.object) ← 
 [CSharp](BuildFromCSharpSourceCode.CSharp.md)
 
-#### Inherited Members
+###### Inherited Members
 
 [object.Equals(object?)](https://learn.microsoft.com/dotnet/api/system.object.equals#system-object-equals(system-object)), 
 [object.Equals(object?, object?)](https://learn.microsoft.com/dotnet/api/system.object.equals#system-object-equals(system-object-system-object)), 
@@ -24,7 +23,7 @@ public class CSharp
 
 ## Methods
 
-### Main(string[])
+### <a id="BuildFromCSharpSourceCode_CSharp_Main_System_String___"></a>Main(string[])
 
 ```csharp
 public static void Main(string[] args)

test/docfx.Snapshot.Tests/SamplesTest.SeedMarkdown/BuildFromCSharpSourceCode.verified.md

@@ -1,6 +1,7 @@
 # Namespace BuildFromCSharpSourceCode
 
-## Classes
+### Classes
 
 [CSharp](BuildFromCSharpSourceCode.CSharp.md)
 
+

test/docfx.Snapshot.Tests/SamplesTest.SeedMarkdown/BuildFromProject.Class1.IIssue8948.verified.md

@@ -1,15 +1,15 @@
 # Interface Class1.IIssue8948
 
-__Namespace:__ [BuildFromProject](BuildFromProject.md)  
-__Assembly:__ BuildFromProject.dll
+Namespace: [BuildFromProject](BuildFromProject.md)  
+Assembly: BuildFromProject.dll
 
 ```csharp
 public interface Class1.IIssue8948
 ```
 
 ## Methods
 
-### DoNothing<T>()
+### <a id="BuildFromProject_Class1_IIssue8948_DoNothing__1"></a>DoNothing<T>()
 
 Does nothing with generic type <code class="typeparamref">T</code>.
 
@@ -19,7 +19,8 @@ void DoNothing<T>()
 
 #### Type Parameters
 
-`T`
+`T` 
 
 A generic type.
 
+

test/docfx.Snapshot.Tests/SamplesTest.SeedMarkdown/BuildFromProject.Class1.Issue8665.verified.md

@@ -1,18 +1,18 @@
 # Class Class1.Issue8665
 
-__Namespace:__ [BuildFromProject](BuildFromProject.md)  
-__Assembly:__ BuildFromProject.dll
+Namespace: [BuildFromProject](BuildFromProject.md)  
+Assembly: BuildFromProject.dll
 
 ```csharp
 public class Class1.Issue8665
 ```
 
-#### Inheritance
+###### Inheritance
 
 [object](https://learn.microsoft.com/dotnet/api/system.object) ← 
-[Class1](BuildFromProject.Class1.md).[Issue8665](BuildFromProject.Class1.Issue8665.md)
+[Class1.Issue8665](BuildFromProject.Class1.Issue8665.md)
 
-#### Inherited Members
+###### Inherited Members
 
 [object.Equals(object?)](https://learn.microsoft.com/dotnet/api/system.object.equals#system-object-equals(system-object)), 
 [object.Equals(object?, object?)](https://learn.microsoft.com/dotnet/api/system.object.equals#system-object-equals(system-object-system-object)), 
@@ -24,13 +24,13 @@ public class Class1.Issue8665
 
 ## Constructors
 
-### Issue8665()
+### <a id="BuildFromProject_Class1_Issue8665__ctor"></a>Issue8665()
 
 ```csharp
 public Issue8665()
 ```
 
-### Issue8665(int)
+### <a id="BuildFromProject_Class1_Issue8665__ctor_System_Int32_"></a>Issue8665(int)
 
 ```csharp
 public Issue8665(int foo)
@@ -40,7 +40,7 @@ public Issue8665(int foo)
 
 `foo` [int](https://learn.microsoft.com/dotnet/api/system.int32)
 
-### Issue8665(int, char)
+### <a id="BuildFromProject_Class1_Issue8665__ctor_System_Int32_System_Char_"></a>Issue8665(int, char)
 
 ```csharp
 public Issue8665(int foo, char bar)
@@ -52,7 +52,7 @@ public Issue8665(int foo, char bar)
 
 `bar` [char](https://learn.microsoft.com/dotnet/api/system.char)
 
-### Issue8665(int, char, string)
+### <a id="BuildFromProject_Class1_Issue8665__ctor_System_Int32_System_Char_System_String_"></a>Issue8665(int, char, string)
 
 ```csharp
 public Issue8665(int foo, char bar, string baz)
@@ -68,33 +68,33 @@ public Issue8665(int foo, char bar, string baz)
 
 ## Properties
 
-### Bar
+### <a id="BuildFromProject_Class1_Issue8665_Bar"></a>Bar
 
 ```csharp
 public char Bar { get; }
 ```
 
-Property Value
+#### Property Value
 
 [char](https://learn.microsoft.com/dotnet/api/system.char)
 
-### Baz
+### <a id="BuildFromProject_Class1_Issue8665_Baz"></a>Baz
 
 ```csharp
 public string Baz { get; }
 ```
 
-Property Value
+#### Property Value
 
 [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-### Foo
+### <a id="BuildFromProject_Class1_Issue8665_Foo"></a>Foo
 
 ```csharp
 public int Foo { get; }
 ```
 
-Property Value
+#### Property Value
 
 [int](https://learn.microsoft.com/dotnet/api/system.int32)
 

test/docfx.Snapshot.Tests/SamplesTest.SeedMarkdown/BuildFromProject.Class1.Issue8696Attribute.verified.md

@@ -1,19 +1,19 @@
 # Class Class1.Issue8696Attribute
 
-__Namespace:__ [BuildFromProject](BuildFromProject.md)  
-__Assembly:__ BuildFromProject.dll
+Namespace: [BuildFromProject](BuildFromProject.md)  
+Assembly: BuildFromProject.dll
 
 ```csharp
 public class Class1.Issue8696Attribute : Attribute
 ```
 
-#### Inheritance
+###### Inheritance
 
 [object](https://learn.microsoft.com/dotnet/api/system.object) ← 
 [Attribute](https://learn.microsoft.com/dotnet/api/system.attribute) ← 
-[Class1](BuildFromProject.Class1.md).[Issue8696Attribute](BuildFromProject.Class1.Issue8696Attribute.md)
+[Class1.Issue8696Attribute](BuildFromProject.Class1.Issue8696Attribute.md)
 
-#### Inherited Members
+###### Inherited Members
 
 [Attribute.Equals(object?)](https://learn.microsoft.com/dotnet/api/system.attribute.equals), 
 [Attribute.GetCustomAttribute(Assembly, Type)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattribute#system-attribute-getcustomattribute(system-reflection-assembly-system-type)), 
@@ -62,7 +62,7 @@ public class Class1.Issue8696Attribute : Attribute
 
 ## Constructors
 
-### Issue8696Attribute(string?, int, int, string[]?, bool, Type?)
+### <a id="BuildFromProject_Class1_Issue8696Attribute__ctor_System_String_System_Int32_System_Int32_System_String___System_Boolean_System_Type_"></a>Issue8696Attribute(string?, int, int, string[]?, bool, Type?)
 
 ```csharp
 [Class1.Issue8696("Changes the name of the server in the server list", 0, 0, null, false, null)]

test/docfx.Snapshot.Tests/SamplesTest.SeedMarkdown/BuildFromProject.Class1.Issue8948.verified.md

@@ -1,22 +1,22 @@
 # Class Class1.Issue8948
 
-__Namespace:__ [BuildFromProject](BuildFromProject.md)  
-__Assembly:__ BuildFromProject.dll
+Namespace: [BuildFromProject](BuildFromProject.md)  
+Assembly: BuildFromProject.dll
 
 ```csharp
 public class Class1.Issue8948 : Class1.IIssue8948
 ```
 
-#### Inheritance
+###### Inheritance
 
 [object](https://learn.microsoft.com/dotnet/api/system.object) ← 
-[Class1](BuildFromProject.Class1.md).[Issue8948](BuildFromProject.Class1.Issue8948.md)
+[Class1.Issue8948](BuildFromProject.Class1.Issue8948.md)
 
-#### Implements
+###### Implements
 
-[Class1](BuildFromProject.Class1.md).[IIssue8948](BuildFromProject.Class1.IIssue8948.md)
+[Class1.IIssue8948](BuildFromProject.Class1.IIssue8948.md)
 
-#### Inherited Members
+###### Inherited Members
 
 [object.Equals(object?)](https://learn.microsoft.com/dotnet/api/system.object.equals#system-object-equals(system-object)), 
 [object.Equals(object?, object?)](https://learn.microsoft.com/dotnet/api/system.object.equals#system-object-equals(system-object-system-object)), 
@@ -28,7 +28,7 @@ public class Class1.Issue8948 : Class1.IIssue8948
 
 ## Methods
 
-### DoNothing<T>()
+### <a id="BuildFromProject_Class1_Issue8948_DoNothing__1"></a>DoNothing<T>()
 
 Does nothing with generic type T.
 
@@ -38,7 +38,7 @@ public void DoNothing<T>()
 
 #### Type Parameters
 
-`T`
+`T` 
 
 A generic type.
 

test/docfx.Snapshot.Tests/SamplesTest.SeedMarkdown/BuildFromProject.Class1.Test-1.verified.md

@@ -1,22 +1,22 @@
 # Class Class1.Test<T>
 
-__Namespace:__ [BuildFromProject](BuildFromProject.md)  
-__Assembly:__ BuildFromProject.dll
+Namespace: [BuildFromProject](BuildFromProject.md)  
+Assembly: BuildFromProject.dll
 
 ```csharp
 public class Class1.Test<T>
 ```
 
-## Type Parameters
+#### Type Parameters
 
-`T`
+`T` 
 
-#### Inheritance
+###### Inheritance
 
 [object](https://learn.microsoft.com/dotnet/api/system.object) ← 
-[Class1](BuildFromProject.Class1.md).[Test](BuildFromProject.Class1.Test-1.md)<T>
+[Class1.Test<T>](BuildFromProject.Class1.Test-1.md)
 
-#### Inherited Members
+###### Inherited Members
 
 [object.Equals(object?)](https://learn.microsoft.com/dotnet/api/system.object.equals#system-object-equals(system-object)), 
 [object.Equals(object?, object?)](https://learn.microsoft.com/dotnet/api/system.object.equals#system-object-equals(system-object-system-object)),