fix: enum summaries correctly format with rich information (#25)

Author: TimothyMakkison

docs/sample/myclasslib.myenum.md

@@ -19,7 +19,7 @@ Implements [IComparable](https://docs.microsoft.com/en-us/dotnet/api/system.icom
 
 | Name | Value | Description |
 | --- | --: | --- |
-| Default | 0 | The default. |
+| Default | 0 | The default value for [MyEnum](./myclasslib.myenum). This is additional information. |
 | First | 1 | The first. |
 | Second | 2 | The second. |
 

sample/MyClassLib/MyEnum.cs

@@ -6,7 +6,8 @@ namespace MyClassLib
     public enum MyEnum
     {
         /// <summary>
-        /// The default.
+        /// The default value for <see cref="MyEnum"/>.
+        /// This is additional information.
         /// </summary>
         Default = 0,
 

src/XMLDoc2Markdown/TypeDocumentation.cs

@@ -3,6 +3,7 @@
 using System.IO;
 using System.Linq;
 using System.Reflection;
+using System.Text;
 using System.Text.RegularExpressions;
 using System.Xml.Linq;
 using Markdown;
@@ -454,14 +455,38 @@ private void WriteEnumFields(IEnumerable<FieldInfo> fields)
 
             foreach (FieldInfo field in fields)
             {
-                string paramDoc = this.documentation.GetMember(field)?.Element("summary")?.Value ?? String.Empty;
-                table.AddRow(new MarkdownTableRow(field.Name, ((Enum)Enum.Parse(this.type, field.Name)).ToString("D"), paramDoc.Trim()));
+                IEnumerable<XNode> nodes = this.documentation.GetMember(field)?.Element("summary")?.Nodes();
+                if (nodes == null)
+                {
+                    continue;
+                }
+
+                MarkdownParagraph summary = this.XNodesToMarkdownParagraph(nodes);
+                string formattedSummary = TableFormat(summary.ToString());
+
+                table.AddRow(new MarkdownTableRow(field.Name, ((Enum)Enum.Parse(this.type, field.Name)).ToString("D"), formattedSummary));
             }
 
             this.document.Append(table);
         }
     }
 
+    private static string TableFormat(string input)
+    {
+        input = input.Replace("\r\n", "\n");
+        StringBuilder sb = new(input.Length);
+
+        foreach (string line in input.Split("\n"))
+        {
+            if (!string.IsNullOrWhiteSpace(line))
+            {
+                sb.Append(line);
+            }
+        }
+
+        return sb.ToString();
+    }
+
     private bool WriteExample(MemberInfo memberInfo)
     {
         if (this.options.ExamplesDirectory == null)