diff --git a/src/Textamina.Markdig/Extensions/Footnotes/HtmlFootnoteGroupRenderer.cs b/src/Textamina.Markdig/Extensions/Footnotes/HtmlFootnoteGroupRenderer.cs
index 59ede3cb..677b6115 100644
--- a/src/Textamina.Markdig/Extensions/Footnotes/HtmlFootnoteGroupRenderer.cs
+++ b/src/Textamina.Markdig/Extensions/Footnotes/HtmlFootnoteGroupRenderer.cs
@@ -8,23 +8,23 @@ namespace Textamina.Markdig.Extensions.Footnotes
 {
     public class HtmlFootnoteGroupRenderer : HtmlObjectRenderer<FootnoteGroup>
     {
-        protected override void Write(HtmlRenderer writer, FootnoteGroup footnoteGroup)
+        protected override void Write(HtmlRenderer renderer, FootnoteGroup footnoteGroup)
         {
             var footnotes = footnoteGroup.Children;
-            writer.EnsureLine();
-            writer.WriteLine("<div class=\"footnotes\">");
-            writer.WriteLine("<hr />");
-            writer.WriteLine("<ol>");
+            renderer.EnsureLine();
+            renderer.WriteLine("<div class=\"footnotes\">");
+            renderer.WriteLine("<hr />");
+            renderer.WriteLine("<ol>");
 
             for (int i = 0; i < footnotes.Count; i++)
             {
                 var footnote = (Footnote)footnotes[i];
-                writer.WriteLine($"<li id=\"fn:{footnote.Order}\">");
-                writer.WriteChildren(footnote);
-                writer.WriteLine("</li>");
+                renderer.WriteLine($"<li id=\"fn:{footnote.Order}\">");
+                renderer.WriteChildren(footnote);
+                renderer.WriteLine("</li>");
             }
-            writer.WriteLine("</ol>");
-            writer.WriteLine("</div>");
+            renderer.WriteLine("</ol>");
+            renderer.WriteLine("</div>");
         }
     }
 }
\ No newline at end of file
diff --git a/src/Textamina.Markdig/Extensions/Footnotes/HtmlFootnoteLinkRenderer.cs b/src/Textamina.Markdig/Extensions/Footnotes/HtmlFootnoteLinkRenderer.cs
index 2f80ffe7..9c6325b4 100644
--- a/src/Textamina.Markdig/Extensions/Footnotes/HtmlFootnoteLinkRenderer.cs
+++ b/src/Textamina.Markdig/Extensions/Footnotes/HtmlFootnoteLinkRenderer.cs
@@ -21,10 +21,10 @@ namespace Textamina.Markdig.Extensions.Footnotes
 
         public string FootnoteBackLinkClass { get; set; }
 
-        protected override void Write(HtmlRenderer writer, FootnoteLink link)
+        protected override void Write(HtmlRenderer renderer, FootnoteLink link)
         {
             var order = link.Footnote.Order ?? 0;
-            writer.Write(link.IsBackLink
+            renderer.Write(link.IsBackLink
                 ? $"<a href=\"#fnref:{link.Index}\" class=\"{FootnoteBackLinkClass}\">{HtmlHelper.Unescape(BackLinkString)}</a>"
                 : $"<a id=\"fnref:{link.Index}\" href=\"#fn:{order}\" class=\"{FootnoteLinkClass}\"><sup>{order}</sup></a>");
         }
diff --git a/src/Textamina.Markdig/Extensions/Tables/HtmlTableRenderer.cs b/src/Textamina.Markdig/Extensions/Tables/HtmlTableRenderer.cs
index 374664c7..59f11f29 100644
--- a/src/Textamina.Markdig/Extensions/Tables/HtmlTableRenderer.cs
+++ b/src/Textamina.Markdig/Extensions/Tables/HtmlTableRenderer.cs
@@ -8,10 +8,10 @@ namespace Textamina.Markdig.Extensions.Tables
 {
     public class HtmlTableRenderer : HtmlObjectRenderer<TableBlock>
     {
-        protected override void Write(HtmlRenderer writer, TableBlock tableBlock)
+        protected override void Write(HtmlRenderer renderer, TableBlock tableBlock)
         {
-            writer.EnsureLine();
-            writer.Write("<table").WriteAttributes(tableBlock).WriteLine(">");
+            renderer.EnsureLine();
+            renderer.Write("<table").WriteAttributes(tableBlock).WriteLine(">");
 
             bool hasBody = false;
             var header = (TableRowBlock)tableBlock.Children[0];
@@ -24,57 +24,57 @@ namespace Textamina.Markdig.Extensions.Tables
                 var row = (TableRowBlock)rowObj;
                 if (row.IsHeader)
                 {
-                    writer.WriteLine("<thead>");
+                    renderer.WriteLine("<thead>");
                 }
                 else if (!hasBody)
                 {
-                    writer.WriteLine("<tbody>");
+                    renderer.WriteLine("<tbody>");
                     hasBody = true;
                 }
-                writer.WriteLine("<tr>");
+                renderer.WriteLine("<tr>");
                 for (int i = 0; i < row.Children.Count; i++)
                 {
                     var cellObj = row.Children[i];
                     var cell = (TableCellBlock)cellObj;
 
-                    writer.EnsureLine();
+                    renderer.EnsureLine();
                     if (row.IsHeader)
                     {
-                        writer.Write("<th");
+                        renderer.Write("<th");
                     }
                     else
                     {
-                        writer.Write("<td");
+                        renderer.Write("<td");
                     }
                     if (header != null && i < header.ColumnAlignments.Count)
                     {
                         switch (header.ColumnAlignments[i])
                         {
                             case TableColumnAlign.Center:
-                                writer.Write(" style=\"text-align: center;\"");
+                                renderer.Write(" style=\"text-align: center;\"");
                                 break;
                             case TableColumnAlign.Right:
-                                writer.Write(" style=\"text-align: right;\"");
+                                renderer.Write(" style=\"text-align: right;\"");
                                 break;
                         }
                     }
-                    writer.Write(">");
+                    renderer.Write(">");
                     
-                    writer.WriteLeafInline(cell);
-                    writer.WriteLine(row.IsHeader ? "</th>" : "</td>");
+                    renderer.WriteLeafInline(cell);
+                    renderer.WriteLine(row.IsHeader ? "</th>" : "</td>");
                 }
-                writer.WriteLine("</tr>");
+                renderer.WriteLine("</tr>");
                 if (row.IsHeader)
                 {
-                    writer.WriteLine("</thead>");
+                    renderer.WriteLine("</thead>");
                 }
             }
 
             if (hasBody)
             {
-                writer.WriteLine("</tbody>");
+                renderer.WriteLine("</tbody>");
             }
-            writer.WriteLine("</table>");
+            renderer.WriteLine("</table>");
         }
     }
 }
\ No newline at end of file
diff --git a/src/Textamina.Markdig/Renderers/Html/CodeBlockRenderer.cs b/src/Textamina.Markdig/Renderers/Html/CodeBlockRenderer.cs
index 5878c0e3..bc042e47 100644
--- a/src/Textamina.Markdig/Renderers/Html/CodeBlockRenderer.cs
+++ b/src/Textamina.Markdig/Renderers/Html/CodeBlockRenderer.cs
@@ -5,6 +5,10 @@ using Textamina.Markdig.Syntax;
 
 namespace Textamina.Markdig.Renderers.Html
 {
+    /// <summary>
+    /// An HTML renderer for a <see cref="CodeBlock"/> and <see cref="FencedCodeBlock"/>.
+    /// </summary>
+    /// <seealso cref="Textamina.Markdig.Renderers.Html.HtmlObjectRenderer{Textamina.Markdig.Syntax.CodeBlock}" />
     public class CodeBlockRenderer : HtmlObjectRenderer<CodeBlock>
     {
         public bool OutputAttributesOnPre { get; set; }
diff --git a/src/Textamina.Markdig/Renderers/Html/HeadingRenderer.cs b/src/Textamina.Markdig/Renderers/Html/HeadingRenderer.cs
index 1a304b62..94490ce1 100644
--- a/src/Textamina.Markdig/Renderers/Html/HeadingRenderer.cs
+++ b/src/Textamina.Markdig/Renderers/Html/HeadingRenderer.cs
@@ -6,6 +6,10 @@ using Textamina.Markdig.Syntax;
 
 namespace Textamina.Markdig.Renderers.Html
 {
+    /// <summary>
+    /// An HTML renderer for a <see cref="HeadingBlock"/>.
+    /// </summary>
+    /// <seealso cref="Textamina.Markdig.Renderers.Html.HtmlObjectRenderer{Textamina.Markdig.Syntax.HeadingBlock}" />
     public class HeadingRenderer : HtmlObjectRenderer<HeadingBlock>
     {
         protected override void Write(HtmlRenderer renderer, HeadingBlock obj)
diff --git a/src/Textamina.Markdig/Renderers/Html/HtmlAttributes.cs b/src/Textamina.Markdig/Renderers/Html/HtmlAttributes.cs
index a8c44a47..5d3cb9c9 100644
--- a/src/Textamina.Markdig/Renderers/Html/HtmlAttributes.cs
+++ b/src/Textamina.Markdig/Renderers/Html/HtmlAttributes.cs
@@ -7,18 +7,37 @@ using Textamina.Markdig.Syntax;
 
 namespace Textamina.Markdig.Renderers.Html
 {
+    /// <summary>
+    /// Attached HTML attributes to a <see cref="MarkdownObject"/>.
+    /// </summary>
     public class HtmlAttributes
     {
+        /// <summary>
+        /// Initializes a new instance of the <see cref="HtmlAttributes"/> class.
+        /// </summary>
         public HtmlAttributes()
         {
         }
 
+        /// <summary>
+        /// Gets or sets the HTML id/identifier. May be null.
+        /// </summary>
         public string Id { get; set; }
 
+        /// <summary>
+        /// Gets or sets the CSS classes attached. May be null.
+        /// </summary>
         public List<string> Classes { get; set; }
 
+        /// <summary>
+        /// Gets or sets the additional properties. May be null.
+        /// </summary>
         public List<KeyValuePair<string, string>> Properties { get; set; }
 
+        /// <summary>
+        /// Adds a CSS class.
+        /// </summary>
+        /// <param name="name">The css class name.</param>
         public void AddClass(string name)
         {
             if (Classes == null)
@@ -28,6 +47,11 @@ namespace Textamina.Markdig.Renderers.Html
             Classes.Add(name);
         }
 
+        /// <summary>
+        /// Adds a property.
+        /// </summary>
+        /// <param name="name">The name.</param>
+        /// <param name="value">The value.</param>
         public void AddProperty(string name, string value)
         {
             if (Properties == null)
@@ -37,6 +61,11 @@ namespace Textamina.Markdig.Renderers.Html
             Properties.Add(new KeyValuePair<string, string>(name, value));
         }
 
+        /// <summary>
+        /// Copies the values from this instance to the specified <see cref="HtmlAttributes"/> instance.
+        /// </summary>
+        /// <param name="htmlAttributes">The HTML attributes.</param>
+        /// <exception cref="System.ArgumentNullException"></exception>
         public void CopyTo(HtmlAttributes htmlAttributes)
         {
             if (htmlAttributes == null) throw new ArgumentNullException(nameof(htmlAttributes));
@@ -62,15 +91,28 @@ namespace Textamina.Markdig.Renderers.Html
         }
     }
 
+    /// <summary>
+    /// Extensions for a <see cref="MarkdownObject"/> to allow accessing <see cref="HtmlAttributes"/>
+    /// </summary>
     public static class HtmlAttributesExtensions
     {
         private static readonly object Key = typeof (HtmlAttributes);
 
+        /// <summary>
+        /// Tries the get <see cref="HtmlAttributes"/> stored on a <see cref="MarkdownObject"/>.
+        /// </summary>
+        /// <param name="obj">The markdown object.</param>
+        /// <returns>The attached html attributes or null if not found</returns>
         public static HtmlAttributes TryGetAttributes(this MarkdownObject obj)
         {
             return obj.GetData(Key) as HtmlAttributes;
         }
 
+        /// <summary>
+        /// Gets or creates the <see cref="HtmlAttributes"/> stored on a <see cref="MarkdownObject"/>
+        /// </summary>
+        /// <param name="obj">The markdown object.</param>
+        /// <returns>The attached html attributes</returns>
         public static HtmlAttributes GetAttributes(this MarkdownObject obj)
         {
             var attributes = obj.GetData(Key) as HtmlAttributes;
diff --git a/src/Textamina.Markdig/Renderers/Html/HtmlBlockRenderer.cs b/src/Textamina.Markdig/Renderers/Html/HtmlBlockRenderer.cs
index 5368ea04..f4df487c 100644
--- a/src/Textamina.Markdig/Renderers/Html/HtmlBlockRenderer.cs
+++ b/src/Textamina.Markdig/Renderers/Html/HtmlBlockRenderer.cs
@@ -5,6 +5,10 @@ using Textamina.Markdig.Syntax;
 
 namespace Textamina.Markdig.Renderers.Html
 {
+    /// <summary>
+    /// A HTML renderer for a <see cref="HtmlBlock"/>.
+    /// </summary>
+    /// <seealso cref="Textamina.Markdig.Renderers.Html.HtmlObjectRenderer{Textamina.Markdig.Syntax.HtmlBlock}" />
     public class HtmlBlockRenderer : HtmlObjectRenderer<HtmlBlock>
     {
         protected override void Write(HtmlRenderer renderer, HtmlBlock obj)
diff --git a/src/Textamina.Markdig/Renderers/Html/HtmlObjectRenderer.cs b/src/Textamina.Markdig/Renderers/Html/HtmlObjectRenderer.cs
index 29f17000..1366b71a 100644
--- a/src/Textamina.Markdig/Renderers/Html/HtmlObjectRenderer.cs
+++ b/src/Textamina.Markdig/Renderers/Html/HtmlObjectRenderer.cs
@@ -1,15 +1,19 @@
 // Copyright (c) Alexandre Mutel. All rights reserved.
 // This file is licensed under the BSD-Clause 2 license. 
 // See the license.txt file in the project root for more information.
-using System;
-using System.Reflection;
 using Textamina.Markdig.Syntax;
+using Textamina.Markdig.Syntax.Inlines;
 
 namespace Textamina.Markdig.Renderers.Html
 {
+    /// <summary>
+    /// A base class for HTML rendering <see cref="Block"/> and <see cref="Inline"/> Markdown objects.
+    /// </summary>
+    /// <typeparam name="TObject">The type of the object.</typeparam>
+    /// <seealso cref="Textamina.Markdig.Renderers.IMarkdownObjectRenderer" />
     public abstract class HtmlObjectRenderer<TObject> : IMarkdownObjectRenderer where TObject : MarkdownObject
     {
-        public virtual bool Accept(RendererBase renderer, object obj)
+        public virtual bool Accept(RendererBase renderer, MarkdownObject obj)
         {
             return obj is TObject;
         }
@@ -19,6 +23,11 @@ namespace Textamina.Markdig.Renderers.Html
             Write((HtmlRenderer)renderer, (TObject)obj);
         }
 
-        protected abstract void Write(HtmlRenderer visitor, TObject obj);
+        /// <summary>
+        /// Writes the specified Markdown object to the renderer.
+        /// </summary>
+        /// <param name="renderer">The renderer.</param>
+        /// <param name="obj">The markdown object.</param>
+        protected abstract void Write(HtmlRenderer renderer, TObject obj);
     }
 }
\ No newline at end of file
diff --git a/src/Textamina.Markdig/Renderers/Html/Inlines/AutolinkInlineRenderer.cs b/src/Textamina.Markdig/Renderers/Html/Inlines/AutolinkInlineRenderer.cs
index f0d86310..3c6cd789 100644
--- a/src/Textamina.Markdig/Renderers/Html/Inlines/AutolinkInlineRenderer.cs
+++ b/src/Textamina.Markdig/Renderers/Html/Inlines/AutolinkInlineRenderer.cs
@@ -5,6 +5,10 @@ using Textamina.Markdig.Syntax.Inlines;
 
 namespace Textamina.Markdig.Renderers.Html.Inlines
 {
+    /// <summary>
+    /// A HTML renderer for an <see cref="AutolinkInline"/>.
+    /// </summary>
+    /// <seealso cref="Textamina.Markdig.Renderers.Html.HtmlObjectRenderer{Textamina.Markdig.Syntax.Inlines.AutolinkInline}" />
     public class AutolinkInlineRenderer : HtmlObjectRenderer<AutolinkInline>
     {
         protected override void Write(HtmlRenderer renderer, AutolinkInline obj)
diff --git a/src/Textamina.Markdig/Renderers/Html/Inlines/CodeInlineRenderer.cs b/src/Textamina.Markdig/Renderers/Html/Inlines/CodeInlineRenderer.cs
index bc21a488..0cbd1897 100644
--- a/src/Textamina.Markdig/Renderers/Html/Inlines/CodeInlineRenderer.cs
+++ b/src/Textamina.Markdig/Renderers/Html/Inlines/CodeInlineRenderer.cs
@@ -1,11 +1,14 @@
 // Copyright (c) Alexandre Mutel. All rights reserved.
 // This file is licensed under the BSD-Clause 2 license. 
 // See the license.txt file in the project root for more information.
-using Textamina.Markdig.Helpers;
 using Textamina.Markdig.Syntax.Inlines;
 
 namespace Textamina.Markdig.Renderers.Html.Inlines
 {
+    /// <summary>
+    /// A HTML renderer for a <see cref="CodeInline"/>.
+    /// </summary>
+    /// <seealso cref="Textamina.Markdig.Renderers.Html.HtmlObjectRenderer{Textamina.Markdig.Syntax.Inlines.CodeInline}" />
     public class CodeInlineRenderer : HtmlObjectRenderer<CodeInline>
     {
         protected override void Write(HtmlRenderer renderer, CodeInline obj)
diff --git a/src/Textamina.Markdig/Renderers/Html/Inlines/DelimiterInlineRenderer.cs b/src/Textamina.Markdig/Renderers/Html/Inlines/DelimiterInlineRenderer.cs
index c4d42f9a..cbae4ba2 100644
--- a/src/Textamina.Markdig/Renderers/Html/Inlines/DelimiterInlineRenderer.cs
+++ b/src/Textamina.Markdig/Renderers/Html/Inlines/DelimiterInlineRenderer.cs
@@ -5,6 +5,10 @@ using Textamina.Markdig.Syntax.Inlines;
 
 namespace Textamina.Markdig.Renderers.Html.Inlines
 {
+    /// <summary>
+    /// A HTML renderer for a <see cref="DelimiterInline"/>.
+    /// </summary>
+    /// <seealso cref="Textamina.Markdig.Renderers.Html.HtmlObjectRenderer{Textamina.Markdig.Syntax.Inlines.DelimiterInline}" />
     public class DelimiterInlineRenderer : HtmlObjectRenderer<DelimiterInline>
     {
         protected override void Write(HtmlRenderer renderer, DelimiterInline obj)
diff --git a/src/Textamina.Markdig/Renderers/Html/Inlines/EmphasisInlineRenderer.cs b/src/Textamina.Markdig/Renderers/Html/Inlines/EmphasisInlineRenderer.cs
index d91a8dc6..4cc001ab 100644
--- a/src/Textamina.Markdig/Renderers/Html/Inlines/EmphasisInlineRenderer.cs
+++ b/src/Textamina.Markdig/Renderers/Html/Inlines/EmphasisInlineRenderer.cs
@@ -5,15 +5,30 @@ using Textamina.Markdig.Syntax.Inlines;
 
 namespace Textamina.Markdig.Renderers.Html.Inlines
 {
+    /// <summary>
+    /// A HTML renderer for an <see cref="EmphasisInline"/>.
+    /// </summary>
+    /// <seealso cref="Textamina.Markdig.Renderers.Html.HtmlObjectRenderer{Textamina.Markdig.Syntax.Inlines.EmphasisInline}" />
     public class EmphasisInlineRenderer : HtmlObjectRenderer<EmphasisInline>
     {
+        /// <summary>
+        /// Delegates to get the tag associated to an <see cref="EmphasisInline"/> object.
+        /// </summary>
+        /// <param name="obj">The object.</param>
+        /// <returns>The HTML tag associated to this <see cref="EmphasisInline"/> object</returns>
         public delegate string GetTagDelegate(EmphasisInline obj);
 
+        /// <summary>
+        /// Initializes a new instance of the <see cref="EmphasisInlineRenderer"/> class.
+        /// </summary>
         public EmphasisInlineRenderer()
         {
             GetTag = GetDefaultTag;
         }
 
+        /// <summary>
+        /// Gets or sets the GetTag delegate.
+        /// </summary>
         public GetTagDelegate GetTag { get; set; }
 
         protected override void Write(HtmlRenderer renderer, EmphasisInline obj)
@@ -31,6 +46,11 @@ namespace Textamina.Markdig.Renderers.Html.Inlines
             }
         }
 
+        /// <summary>
+        /// Gets the default HTML tag for ** and __ emphasis.
+        /// </summary>
+        /// <param name="obj">The object.</param>
+        /// <returns></returns>
         public string GetDefaultTag(EmphasisInline obj)
         {
             if (obj.DelimiterChar == '*' || obj.DelimiterChar == '_')
diff --git a/src/Textamina.Markdig/Renderers/Html/Inlines/HardlineBreakInlineRenderer.cs b/src/Textamina.Markdig/Renderers/Html/Inlines/HardlineBreakInlineRenderer.cs
index bda9d410..edef1a8f 100644
--- a/src/Textamina.Markdig/Renderers/Html/Inlines/HardlineBreakInlineRenderer.cs
+++ b/src/Textamina.Markdig/Renderers/Html/Inlines/HardlineBreakInlineRenderer.cs
@@ -5,6 +5,10 @@ using Textamina.Markdig.Syntax.Inlines;
 
 namespace Textamina.Markdig.Renderers.Html.Inlines
 {
+    /// <summary>
+    /// A HTML renderer for a <see cref="HardlineBreakInline"/>.
+    /// </summary>
+    /// <seealso cref="Textamina.Markdig.Renderers.Html.HtmlObjectRenderer{Textamina.Markdig.Syntax.Inlines.HardlineBreakInline}" />
     public class HardlineBreakInlineRenderer : HtmlObjectRenderer<HardlineBreakInline>
     {
         protected override void Write(HtmlRenderer renderer, HardlineBreakInline obj)
diff --git a/src/Textamina.Markdig/Renderers/Html/Inlines/HtmlInlineRenderer.cs b/src/Textamina.Markdig/Renderers/Html/Inlines/HtmlInlineRenderer.cs
index 4621ff32..b038cbb8 100644
--- a/src/Textamina.Markdig/Renderers/Html/Inlines/HtmlInlineRenderer.cs
+++ b/src/Textamina.Markdig/Renderers/Html/Inlines/HtmlInlineRenderer.cs
@@ -5,6 +5,10 @@ using Textamina.Markdig.Syntax.Inlines;
 
 namespace Textamina.Markdig.Renderers.Html.Inlines
 {
+    /// <summary>
+    /// A HTML renderer for a <see cref="HtmlInline"/>.
+    /// </summary>
+    /// <seealso cref="Textamina.Markdig.Renderers.Html.HtmlObjectRenderer{Textamina.Markdig.Syntax.Inlines.HtmlInline}" />
     public class HtmlInlineRenderer : HtmlObjectRenderer<HtmlInline>
     {
         protected override void Write(HtmlRenderer renderer, HtmlInline obj)
diff --git a/src/Textamina.Markdig/Renderers/Html/Inlines/LinkInlineRenderer.cs b/src/Textamina.Markdig/Renderers/Html/Inlines/LinkInlineRenderer.cs
index 13408425..7d9aa331 100644
--- a/src/Textamina.Markdig/Renderers/Html/Inlines/LinkInlineRenderer.cs
+++ b/src/Textamina.Markdig/Renderers/Html/Inlines/LinkInlineRenderer.cs
@@ -5,6 +5,10 @@ using Textamina.Markdig.Syntax.Inlines;
 
 namespace Textamina.Markdig.Renderers.Html.Inlines
 {
+    /// <summary>
+    /// A HTML renderer for a <see cref="LinkInline"/>.
+    /// </summary>
+    /// <seealso cref="Textamina.Markdig.Renderers.Html.HtmlObjectRenderer{Textamina.Markdig.Syntax.Inlines.LinkInline}" />
     public class LinkInlineRenderer : HtmlObjectRenderer<LinkInline>
     {
         protected override void Write(HtmlRenderer renderer, LinkInline link)
diff --git a/src/Textamina.Markdig/Renderers/Html/Inlines/LiteralInlineRenderer.cs b/src/Textamina.Markdig/Renderers/Html/Inlines/LiteralInlineRenderer.cs
index 3b8a57eb..38bf30bc 100644
--- a/src/Textamina.Markdig/Renderers/Html/Inlines/LiteralInlineRenderer.cs
+++ b/src/Textamina.Markdig/Renderers/Html/Inlines/LiteralInlineRenderer.cs
@@ -5,6 +5,10 @@ using Textamina.Markdig.Syntax.Inlines;
 
 namespace Textamina.Markdig.Renderers.Html.Inlines
 {
+    /// <summary>
+    /// A HTML renderer for a <see cref="LiteralInline"/>.
+    /// </summary>
+    /// <seealso cref="Textamina.Markdig.Renderers.Html.HtmlObjectRenderer{Textamina.Markdig.Syntax.Inlines.LiteralInline}" />
     public class LiteralInlineRenderer : HtmlObjectRenderer<LiteralInline>
     {
         protected override void Write(HtmlRenderer renderer, LiteralInline obj)
diff --git a/src/Textamina.Markdig/Renderers/Html/Inlines/SoftlineBreakInlineRenderer.cs b/src/Textamina.Markdig/Renderers/Html/Inlines/SoftlineBreakInlineRenderer.cs
index df9eb7bf..3f882aa4 100644
--- a/src/Textamina.Markdig/Renderers/Html/Inlines/SoftlineBreakInlineRenderer.cs
+++ b/src/Textamina.Markdig/Renderers/Html/Inlines/SoftlineBreakInlineRenderer.cs
@@ -5,8 +5,15 @@ using Textamina.Markdig.Syntax.Inlines;
 
 namespace Textamina.Markdig.Renderers.Html.Inlines
 {
+    /// <summary>
+    /// A HTML renderer for a <see cref="SoftlineBreakInline"/>.
+    /// </summary>
+    /// <seealso cref="Textamina.Markdig.Renderers.Html.HtmlObjectRenderer{Textamina.Markdig.Syntax.Inlines.SoftlineBreakInline}" />
     public class SoftlineBreakInlineRenderer : HtmlObjectRenderer<SoftlineBreakInline>
     {
+        /// <summary>
+        /// Gets or sets a value indicating whether to render this softline break as a HTML hardline break tag (&lt;br /&gt;)
+        /// </summary>
         public bool RenderAsHardlineBreak { get; set; }
 
         protected override void Write(HtmlRenderer renderer, SoftlineBreakInline obj)
diff --git a/src/Textamina.Markdig/Renderers/Html/ListRenderer.cs b/src/Textamina.Markdig/Renderers/Html/ListRenderer.cs
index eceb2bce..90f081f6 100644
--- a/src/Textamina.Markdig/Renderers/Html/ListRenderer.cs
+++ b/src/Textamina.Markdig/Renderers/Html/ListRenderer.cs
@@ -6,6 +6,10 @@ using Textamina.Markdig.Syntax;
 
 namespace Textamina.Markdig.Renderers.Html
 {
+    /// <summary>
+    /// A HTML renderer for a <see cref="ListBlock"/>.
+    /// </summary>
+    /// <seealso cref="Textamina.Markdig.Renderers.Html.HtmlObjectRenderer{Textamina.Markdig.Syntax.ListBlock}" />
     public class ListRenderer : HtmlObjectRenderer<ListBlock>
     {
         protected override void Write(HtmlRenderer renderer, ListBlock listBlock)
diff --git a/src/Textamina.Markdig/Renderers/Html/ParagraphRenderer.cs b/src/Textamina.Markdig/Renderers/Html/ParagraphRenderer.cs
index 8b0242d4..cf92791d 100644
--- a/src/Textamina.Markdig/Renderers/Html/ParagraphRenderer.cs
+++ b/src/Textamina.Markdig/Renderers/Html/ParagraphRenderer.cs
@@ -5,6 +5,10 @@ using Textamina.Markdig.Syntax;
 
 namespace Textamina.Markdig.Renderers.Html
 {
+    /// <summary>
+    /// A HTML renderer for a <see cref="ParagraphBlock"/>.
+    /// </summary>
+    /// <seealso cref="Textamina.Markdig.Renderers.Html.HtmlObjectRenderer{Textamina.Markdig.Syntax.ParagraphBlock}" />
     public class ParagraphRenderer : HtmlObjectRenderer<ParagraphBlock>
     {
         protected override void Write(HtmlRenderer renderer, ParagraphBlock obj)
diff --git a/src/Textamina.Markdig/Renderers/Html/QuoteBlockRenderer.cs b/src/Textamina.Markdig/Renderers/Html/QuoteBlockRenderer.cs
index 108cfa11..529bf4cc 100644
--- a/src/Textamina.Markdig/Renderers/Html/QuoteBlockRenderer.cs
+++ b/src/Textamina.Markdig/Renderers/Html/QuoteBlockRenderer.cs
@@ -5,6 +5,10 @@ using Textamina.Markdig.Syntax;
 
 namespace Textamina.Markdig.Renderers.Html
 {
+    /// <summary>
+    /// A HTML renderer for a <see cref="QuoteBlock"/>.
+    /// </summary>
+    /// <seealso cref="Textamina.Markdig.Renderers.Html.HtmlObjectRenderer{Textamina.Markdig.Syntax.QuoteBlock}" />
     public class QuoteBlockRenderer : HtmlObjectRenderer<QuoteBlock>
     {
         protected override void Write(HtmlRenderer renderer, QuoteBlock obj)
diff --git a/src/Textamina.Markdig/Renderers/Html/ThematicBreakRenderer.cs b/src/Textamina.Markdig/Renderers/Html/ThematicBreakRenderer.cs
index 2ef531eb..ea8a7ea8 100644
--- a/src/Textamina.Markdig/Renderers/Html/ThematicBreakRenderer.cs
+++ b/src/Textamina.Markdig/Renderers/Html/ThematicBreakRenderer.cs
@@ -5,6 +5,10 @@ using Textamina.Markdig.Syntax;
 
 namespace Textamina.Markdig.Renderers.Html
 {
+    /// <summary>
+    /// A HTML renderer for a <see cref="ThematicBreakBlock"/>.
+    /// </summary>
+    /// <seealso cref="Textamina.Markdig.Renderers.Html.HtmlObjectRenderer{Textamina.Markdig.Syntax.ThematicBreakBlock}" />
     public class ThematicBreakRenderer : HtmlObjectRenderer<ThematicBreakBlock>
     {
         protected override void Write(HtmlRenderer renderer, ThematicBreakBlock obj)
diff --git a/src/Textamina.Markdig/Renderers/HtmlRenderer.cs b/src/Textamina.Markdig/Renderers/HtmlRenderer.cs
index 3a69b7a2..24ebcb97 100644
--- a/src/Textamina.Markdig/Renderers/HtmlRenderer.cs
+++ b/src/Textamina.Markdig/Renderers/HtmlRenderer.cs
@@ -11,8 +11,16 @@ using Textamina.Markdig.Syntax;
 
 namespace Textamina.Markdig.Renderers
 {
+    /// <summary>
+    /// Default HTML renderer for a Markdown <see cref="Document"/> object.
+    /// </summary>
+    /// <seealso cref="Textamina.Markdig.Renderers.TextRendererBase{Textamina.Markdig.Renderers.HtmlRenderer}" />
     public class HtmlRenderer : TextRendererBase<HtmlRenderer>
     {
+        /// <summary>
+        /// Initializes a new instance of the <see cref="HtmlRenderer"/> class.
+        /// </summary>
+        /// <param name="writer">The writer.</param>
         public HtmlRenderer(TextWriter writer) : base(writer)
         {
             // Default block renderers
@@ -38,10 +46,24 @@ namespace Textamina.Markdig.Renderers
             EnableHtmlForInline = true;
         }
 
+        /// <summary>
+        /// Gets or sets a value indicating whether to ouput HTML tags when rendering. See remarks.
+        /// </summary>
+        /// <remarks>
+        /// This is used by some renderers to disable HTML tags when rendering some inlines (for image links).
+        /// </remarks>
         public bool EnableHtmlForInline { get; set; }
 
+        /// <summary>
+        /// Gets or sets a value indicating whether to use implicit paragraph (optional &lt;p&gt;)
+        /// </summary>
         public bool ImplicitParagraph { get; set; }
 
+        /// <summary>
+        /// Writes the content escaped for HTML.
+        /// </summary>
+        /// <param name="content">The content.</param>
+        /// <returns>This instance</returns>
         [MethodImpl(MethodImplOptionPortable.AggressiveInlining)]
         public HtmlRenderer WriteEscape(string content)
         {
@@ -52,6 +74,11 @@ namespace Textamina.Markdig.Renderers
             return this;
         }
 
+        /// <summary>
+        /// Writes the content escaped for HTML.
+        /// </summary>
+        /// <param name="slice">The slice.</param>
+        /// <returns>This instance</returns>
         [MethodImpl(MethodImplOptionPortable.AggressiveInlining)]
         public HtmlRenderer WriteEscape(ref StringSlice slice)
         {
@@ -62,6 +89,13 @@ namespace Textamina.Markdig.Renderers
             return WriteEscape(slice.Text, slice.Start, slice.Length);
         }
 
+        /// <summary>
+        /// Writes the content escaped for HTML.
+        /// </summary>
+        /// <param name="content">The content.</param>
+        /// <param name="offset">The offset.</param>
+        /// <param name="length">The length.</param>
+        /// <returns>This instance</returns>
         public HtmlRenderer WriteEscape(string content, int offset, int length)
         {
             if (string.IsNullOrEmpty(content) || length == 0)
@@ -100,6 +134,11 @@ namespace Textamina.Markdig.Renderers
             return this;
         }
 
+        /// <summary>
+        /// Writes the URL escaped for HTML.
+        /// </summary>
+        /// <param name="content">The content.</param>
+        /// <returns>This instance</returns>
         public HtmlRenderer WriteEscapeUrl(string content)
         {
             if (content == null)
@@ -151,6 +190,11 @@ namespace Textamina.Markdig.Renderers
             return this;
         }
 
+        /// <summary>
+        /// Writes the attached <see cref="HtmlAttributes"/> on the specified <see cref="MarkdownObject"/>.
+        /// </summary>
+        /// <param name="obj">The object.</param>
+        /// <returns></returns>
         public HtmlRenderer WriteAttributes(MarkdownObject obj)
         {
             var attributes = obj.TryGetAttributes();
@@ -191,6 +235,13 @@ namespace Textamina.Markdig.Renderers
             return this;
         }
 
+        /// <summary>
+        /// Writes the lines of a <see cref="LeafBlock"/>
+        /// </summary>
+        /// <param name="leafBlock">The leaf block.</param>
+        /// <param name="writeEndOfLines">if set to <c>true</c> write end of lines.</param>
+        /// <param name="escape">if set to <c>true</c> escape the content for HTML</param>
+        /// <returns>This instance</returns>
         public HtmlRenderer WriteLeafRawLines(LeafBlock leafBlock, bool writeEndOfLines, bool escape)
         {
             if (leafBlock.Lines != null)
diff --git a/src/Textamina.Markdig/Renderers/IMarkdownObjectRenderer.cs b/src/Textamina.Markdig/Renderers/IMarkdownObjectRenderer.cs
index df5fd017..97f491d7 100644
--- a/src/Textamina.Markdig/Renderers/IMarkdownObjectRenderer.cs
+++ b/src/Textamina.Markdig/Renderers/IMarkdownObjectRenderer.cs
@@ -1,15 +1,29 @@
 // Copyright (c) Alexandre Mutel. All rights reserved.
 // This file is licensed under the BSD-Clause 2 license. 
 // See the license.txt file in the project root for more information.
-using System;
+
 using Textamina.Markdig.Syntax;
 
 namespace Textamina.Markdig.Renderers
 {
+    /// <summary>
+    /// Base interface for the renderer of a <see cref="MarkdownObject"/>.
+    /// </summary>
     public interface IMarkdownObjectRenderer
     {
-        bool Accept(RendererBase renderer, object obj);
+        /// <summary>
+        /// Accepts the specified <see cref="MarkdownObject"/>.
+        /// </summary>
+        /// <param name="renderer">The renderer.</param>
+        /// <param name="obj">The Markdown object.</param>
+        /// <returns><c>true</c> If this renderer is accepting to render the specified Markdown object</returns>
+        bool Accept(RendererBase renderer, MarkdownObject obj);
 
+        /// <summary>
+        /// Writes the specified <see cref="MarkdownObject"/> to the <see cref="renderer"/>.
+        /// </summary>
+        /// <param name="renderer">The renderer.</param>
+        /// <param name="objectToRender">The object to render.</param>
         void Write(RendererBase renderer, MarkdownObject objectToRender);
     }
 }
\ No newline at end of file
diff --git a/src/Textamina.Markdig/Renderers/IMarkdownRenderer.cs b/src/Textamina.Markdig/Renderers/IMarkdownRenderer.cs
index 6b147f81..167fceb1 100644
--- a/src/Textamina.Markdig/Renderers/IMarkdownRenderer.cs
+++ b/src/Textamina.Markdig/Renderers/IMarkdownRenderer.cs
@@ -2,13 +2,25 @@
 // This file is licensed under the BSD-Clause 2 license. 
 // See the license.txt file in the project root for more information.
 using Textamina.Markdig.Syntax;
+using Textamina.Markdig.Syntax.Inlines;
 
 namespace Textamina.Markdig.Renderers
 {
+    /// <summary>
+    /// Base interface for a renderer for a Markdown <see cref="Document"/>.
+    /// </summary>
     public interface IMarkdownRenderer
     {
+        /// <summary>
+        /// Gets the object renderers that will render <see cref="Block"/> and <see cref="Inline"/> elements.
+        /// </summary>
         ObjectRendererCollection ObjectRenderers { get; }
 
+        /// <summary>
+        /// Renders the specified markdown object.
+        /// </summary>
+        /// <param name="markdownObject">The markdown object.</param>
+        /// <returns>The result of the rendering.</returns>
         object Render(MarkdownObject markdownObject);
     }
 }
\ No newline at end of file
diff --git a/src/Textamina.Markdig/Renderers/ObjectRendererCollection.cs b/src/Textamina.Markdig/Renderers/ObjectRendererCollection.cs
index 9573b07b..de650511 100644
--- a/src/Textamina.Markdig/Renderers/ObjectRendererCollection.cs
+++ b/src/Textamina.Markdig/Renderers/ObjectRendererCollection.cs
@@ -5,6 +5,10 @@ using Textamina.Markdig.Helpers;
 
 namespace Textamina.Markdig.Renderers
 {
+    /// <summary>
+    /// A collection of <see cref="IMarkdownObjectRenderer"/>.
+    /// </summary>
+    /// <seealso cref="Textamina.Markdig.Helpers.OrderedList{Textamina.Markdig.Renderers.IMarkdownObjectRenderer}" />
     public class ObjectRendererCollection : OrderedList<IMarkdownObjectRenderer>
     {
     }
diff --git a/src/Textamina.Markdig/Renderers/RendererBase.cs b/src/Textamina.Markdig/Renderers/RendererBase.cs
index c09e276d..63460613 100644
--- a/src/Textamina.Markdig/Renderers/RendererBase.cs
+++ b/src/Textamina.Markdig/Renderers/RendererBase.cs
@@ -8,12 +8,19 @@ using Textamina.Markdig.Syntax.Inlines;
 
 namespace Textamina.Markdig.Renderers
 {
+    /// <summary>
+    /// Base class for a <see cref="IMarkdownRenderer"/>.
+    /// </summary>
+    /// <seealso cref="Textamina.Markdig.Renderers.IMarkdownRenderer" />
     public abstract class RendererBase : IMarkdownRenderer
     {
         private readonly Dictionary<Type, IMarkdownObjectRenderer> renderersPerType;
         private IMarkdownObjectRenderer previousRenderer;
         private Type previousObjectType;
 
+        /// <summary>
+        /// Initializes a new instance of the <see cref="RendererBase"/> class.
+        /// </summary>
         protected RendererBase()
         {
             ObjectRenderers = new ObjectRendererCollection();
@@ -24,6 +31,10 @@ namespace Textamina.Markdig.Renderers
 
         public abstract object Render(MarkdownObject markdownObject);
 
+        /// <summary>
+        /// Writes the children of the specified <see cref="ContainerBlock"/>.
+        /// </summary>
+        /// <param name="containerBlock">The container block.</param>
         public void WriteChildren(ContainerBlock containerBlock)
         {
             if (containerBlock == null)
@@ -38,6 +49,10 @@ namespace Textamina.Markdig.Renderers
             }
         }
 
+        /// <summary>
+        /// Writes the children of the specified <see cref="ContainerInline"/>.
+        /// </summary>
+        /// <param name="containerInline">The container inline.</param>
         public void WriteChildren(ContainerInline containerInline)
         {
             if (containerInline == null)
@@ -53,6 +68,11 @@ namespace Textamina.Markdig.Renderers
             }
         }
 
+        /// <summary>
+        /// Writes the specified Markdown object.
+        /// </summary>
+        /// <typeparam name="T">A MarkdownObject type</typeparam>
+        /// <param name="obj">The Markdown object to write to this renderer.</param>
         public void Write<T>(T obj) where T : MarkdownObject
         {
             if (obj == null)
diff --git a/src/Textamina.Markdig/Renderers/TextRendererBase.cs b/src/Textamina.Markdig/Renderers/TextRendererBase.cs
index 9034ce86..42a62359 100644
--- a/src/Textamina.Markdig/Renderers/TextRendererBase.cs
+++ b/src/Textamina.Markdig/Renderers/TextRendererBase.cs
@@ -10,16 +10,29 @@ using Textamina.Markdig.Syntax.Inlines;
 
 namespace Textamina.Markdig.Renderers
 {
+    /// <summary>
+    /// A text based <see cref="IMarkdownRenderer"/>.
+    /// </summary>
+    /// <seealso cref="Textamina.Markdig.Renderers.RendererBase" />
     public abstract class TextRendererBase : RendererBase
     {
         private TextWriter writer;
 
+        /// <summary>
+        /// Initializes a new instance of the <see cref="TextRendererBase"/> class.
+        /// </summary>
+        /// <param name="writer">The writer.</param>
+        /// <exception cref="System.ArgumentNullException"></exception>
         protected TextRendererBase(TextWriter writer)
         {
             if (writer == null) throw new ArgumentNullException(nameof(writer));
             this.Writer = writer;
         }
 
+        /// <summary>
+        /// Gets or sets the writer.
+        /// </summary>
+        /// <exception cref="System.ArgumentNullException">if the value is null</exception>
         public TextWriter Writer
         {
             get { return writer; }
@@ -34,6 +47,11 @@ namespace Textamina.Markdig.Renderers
             }
         }
 
+        /// <summary>
+        /// Renders the specified markdown object (returns the <see cref="Writer"/> as a render object).
+        /// </summary>
+        /// <param name="markdownObject">The markdown object.</param>
+        /// <returns></returns>
         public override object Render(MarkdownObject markdownObject)
         {
             Write(markdownObject);
@@ -41,11 +59,20 @@ namespace Textamina.Markdig.Renderers
         }
     }
 
+    /// <summary>
+    /// Typed <see cref="TextRendererBase"/>.
+    /// </summary>
+    /// <typeparam name="T">Type of the renderer</typeparam>
+    /// <seealso cref="Textamina.Markdig.Renderers.RendererBase" />
     public abstract class TextRendererBase<T> : TextRendererBase where T : TextRendererBase<T>
     {
         private bool previousWasLine;
         private char[] buffer;
 
+        /// <summary>
+        /// Initializes a new instance of the <see cref="TextRendererBase{T}"/> class.
+        /// </summary>
+        /// <param name="writer">The writer.</param>
         protected TextRendererBase(TextWriter writer) : base(writer)
         {
             buffer = new char[1024];
@@ -53,6 +80,10 @@ namespace Textamina.Markdig.Renderers
             previousWasLine = true;
         }
 
+        /// <summary>
+        /// Ensures a newline.
+        /// </summary>
+        /// <returns>This instance</returns>
         public T EnsureLine()
         {
             if (!previousWasLine)
@@ -62,6 +93,11 @@ namespace Textamina.Markdig.Renderers
             return (T)this;
         }
 
+        /// <summary>
+        /// Writes the specified content.
+        /// </summary>
+        /// <param name="content">The content.</param>
+        /// <returns>This instance</returns>
         [MethodImpl(MethodImplOptionPortable.AggressiveInlining)]
         public T Write(string content)
         {
@@ -70,6 +106,11 @@ namespace Textamina.Markdig.Renderers
             return (T) this;
         }
 
+        /// <summary>
+        /// Writes the specified slice.
+        /// </summary>
+        /// <param name="slice">The slice.</param>
+        /// <returns>This instance</returns>
         [MethodImpl(MethodImplOptionPortable.AggressiveInlining)]
         public T Write(ref StringSlice slice)
         {
@@ -80,6 +121,11 @@ namespace Textamina.Markdig.Renderers
             return Write(slice.Text, slice.Start, slice.Length);
         }
 
+        /// <summary>
+        /// Writes the specified character.
+        /// </summary>
+        /// <param name="content">The content.</param>
+        /// <returns>This instance</returns>
         [MethodImpl(MethodImplOptionPortable.AggressiveInlining)]
         public T Write(char content)
         {
@@ -88,6 +134,13 @@ namespace Textamina.Markdig.Renderers
             return (T) this;
         }
 
+        /// <summary>
+        /// Writes the specified content.
+        /// </summary>
+        /// <param name="content">The content.</param>
+        /// <param name="offset">The offset.</param>
+        /// <param name="length">The length.</param>
+        /// <returns>This instance</returns>
         public T Write(string content, int offset, int length)
         {
             previousWasLine = false;
@@ -111,6 +164,10 @@ namespace Textamina.Markdig.Renderers
             return (T) this;
         }
 
+        /// <summary>
+        /// Writes a newline.
+        /// </summary>
+        /// <returns>This instance</returns>
         [MethodImpl(MethodImplOptionPortable.AggressiveInlining)]
         public T WriteLine()
         {
@@ -119,6 +176,11 @@ namespace Textamina.Markdig.Renderers
             return (T) this;
         }
 
+        /// <summary>
+        /// Writes a content followed by a newline.
+        /// </summary>
+        /// <param name="content">The content.</param>
+        /// <returns>This instance</returns>
         [MethodImpl(MethodImplOptionPortable.AggressiveInlining)]
         public T WriteLine(string content)
         {
@@ -127,6 +189,11 @@ namespace Textamina.Markdig.Renderers
             return (T) this;
         }
 
+        /// <summary>
+        /// Writes the inlines of a leaf inline.
+        /// </summary>
+        /// <param name="leafBlock">The leaf block.</param>
+        /// <returns>This instance</returns>
         [MethodImpl(MethodImplOptionPortable.AggressiveInlining)]
         public T WriteLeafInline(LeafBlock leafBlock)
         {