HtmlRender.Render() not equivalent to Markdown.ToHtml() #502

New Issue

claunia · 2026-01-29T14:38:20Z

claunia commented

2026-01-29 14:38:20 +00:00

Originally created by @jo3w4rd on GitHub (Feb 8, 2022).

Are these expected to produce the same results? When using the PipeTables extension, Render() simply wraps the table cells in p tags (without and table, tbody, etc.). ToHtml() produces the full HTML table, as expected.

HtmlRender.Render() never hits a breakpoint in the HtmlTableRender.Write() method, whereas ToHtml() does. Am I missing a step for setting up the renderer object?

        public static void ParseMarkdown(string markdown)
        {
            var pipeline = new MarkdownPipelineBuilder().UsePipeTables().Build();
            MarkdownDocument md = Markdown.Parse(markdown, pipeline);
            var testStringA = md.ToHtml(pipeline);
            
            var stWriter = new StringWriter();
            var renderer = new HtmlRenderer(stWriter);
            renderer.Render(md);
            var testStringB = stWriter.ToString();
            
            Console.WriteLine(testStringA);
            Console.WriteLine(testStringB);
        }

(For context, I am exploring writing a different renderer.)

ToHTML() output (testStringA)

<h1>Table</h1>
<table>
<thead>
<tr>
<th><strong>Property</strong></th>
<th><strong>Description</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>Interaction Manager</strong></td>
<td>The <a href="xr-interaction-manager.md">XRInteractionManager</a> that this Interactable will communicate with (will find one if <strong>None</strong>).</td>
</tr>
<tr>
<td><strong>Interaction Layer Mask</strong></td>
<td>Allows interaction with Interactors whose <a href="interaction-layers.md">Interaction Layer Mask</a> overlaps with any Layer in this Interaction Layer Mask.</td>
</tr>
<tr>
<td><strong>Colliders</strong></td>
<td>Colliders to use for interaction with this Interactable (if empty, will use any child Colliders).</td>
</tr>
</tbody>
</table>

Render() (testStringB):

<h1>Table</h1>
<p><strong>Property</strong></p>
<p><strong>Description</strong></p>
<p><strong>Interaction Manager</strong></p>
<p>The <a href="xr-interaction-manager.md">XRInteractionManager</a> that this Interactable will communicate with (will find one if <strong>None</strong>).</p>
<p><strong>Interaction Layer Mask</strong></p>
<p>Allows interaction with Interactors whose <a href="interaction-layers.md">Interaction Layer Mask</a> overlaps with any Layer in this Interaction Layer Mask.</p>
<p><strong>Colliders</strong></p>
<p>Colliders to use for interaction with this Interactable (if empty, will use any child Colliders).</p>

Input markdown:

# Table

| **Property**               | **Description**                                                                                                                                   |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Interaction Manager**    | The [XRInteractionManager](xr-interaction-manager.md) that this Interactable will communicate with (will find one if **None**).                   |
| **Interaction Layer Mask** | Allows interaction with Interactors whose [Interaction Layer Mask](interaction-layers.md) overlaps with any Layer in this Interaction Layer Mask. |
| **Colliders**              | Colliders to use for interaction with this Interactable (if empty, will use any child Colliders).                                                 |

Originally created by @jo3w4rd on GitHub (Feb 8, 2022). Are these expected to produce the same results? When using the PipeTables extension, `Render()` simply wraps the table cells in `p` tags (without and `table`, `tbody`, etc.). `ToHtml()` produces the full HTML table, as expected. `HtmlRender.Render()` never hits a breakpoint in the `HtmlTableRender.Write()` method, whereas `ToHtml()` does. Am I missing a step for setting up the renderer object? ``` public static void ParseMarkdown(string markdown) { var pipeline = new MarkdownPipelineBuilder().UsePipeTables().Build(); MarkdownDocument md = Markdown.Parse(markdown, pipeline); var testStringA = md.ToHtml(pipeline); var stWriter = new StringWriter(); var renderer = new HtmlRenderer(stWriter); renderer.Render(md); var testStringB = stWriter.ToString(); Console.WriteLine(testStringA); Console.WriteLine(testStringB); } ``` (For context, I am exploring writing a different renderer.) `ToHTML()` output (testStringA) ``` <h1>Table</h1> <table> <thead> <tr> <th><strong>Property</strong></th> <th><strong>Description</strong></th> </tr> </thead> <tbody> <tr> <td><strong>Interaction Manager</strong></td> <td>The <a href="xr-interaction-manager.md">XRInteractionManager</a> that this Interactable will communicate with (will find one if <strong>None</strong>).</td> </tr> <tr> <td><strong>Interaction Layer Mask</strong></td> <td>Allows interaction with Interactors whose <a href="interaction-layers.md">Interaction Layer Mask</a> overlaps with any Layer in this Interaction Layer Mask.</td> </tr> <tr> <td><strong>Colliders</strong></td> <td>Colliders to use for interaction with this Interactable (if empty, will use any child Colliders).</td> </tr> </tbody> </table> ``` `Render()` (testStringB): ``` <h1>Table</h1> <p><strong>Property</strong></p> <p><strong>Description</strong></p> <p><strong>Interaction Manager</strong></p> <p>The <a href="xr-interaction-manager.md">XRInteractionManager</a> that this Interactable will communicate with (will find one if <strong>None</strong>).</p> <p><strong>Interaction Layer Mask</strong></p> <p>Allows interaction with Interactors whose <a href="interaction-layers.md">Interaction Layer Mask</a> overlaps with any Layer in this Interaction Layer Mask.</p> <p><strong>Colliders</strong></p> <p>Colliders to use for interaction with this Interactable (if empty, will use any child Colliders).</p> ``` Input markdown: ``` # Table | **Property** | **Description** | | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | | **Interaction Manager** | The [XRInteractionManager](xr-interaction-manager.md) that this Interactable will communicate with (will find one if **None**). | | **Interaction Layer Mask** | Allows interaction with Interactors whose [Interaction Layer Mask](interaction-layers.md) overlaps with any Layer in this Interaction Layer Mask. | | **Colliders** | Colliders to use for interaction with this Interactable (if empty, will use any child Colliders). | ```

claunia closed this issue

2026-01-29 14:38:20 +00:00

claunia commented

2026-01-29 14:38:20 +00:00

@MihaZupan commented on GitHub (Feb 8, 2022):

You were very close :)

var renderer = new HtmlRenderer(stWriter);
+pipeline.Setup(renderer);
renderer.Render(md);

Effectively, you weren't adding an HtmlTableRenderer to the HtmlRenderer, so there was no renderer accepting a Table element.

So if you were to write a custom table renderer, you most likely want to setup the HtmlRenderer and then replace the HtmlTableRenderer:

var renderer = new HtmlRenderer(stWriter);

pipeline.Setup(renderer);
renderer.ObjectRenderers.ReplaceOrAdd<HtmlTableRenderer>(MyNewTableRenderer);

renderer.Render(md);

@MihaZupan commented on GitHub (Feb 8, 2022): You were very close :) ```diff var renderer = new HtmlRenderer(stWriter); +pipeline.Setup(renderer); renderer.Render(md); ``` Effectively, you [weren't adding](https://github.com/xoofx/markdig/blob/996b04cadbdfcd8b192f259b3a3b8679feb20feb/src/Markdig/Extensions/Tables/PipeTableExtension.cs#L45-L51) an `HtmlTableRenderer` to the `HtmlRenderer`, so there was no renderer accepting a `Table` element. So if you were to write a custom table renderer, you most likely want to setup the `HtmlRenderer` and then replace the `HtmlTableRenderer`: ```c# var renderer = new HtmlRenderer(stWriter); pipeline.Setup(renderer); renderer.ObjectRenderers.ReplaceOrAdd<HtmlTableRenderer>(MyNewTableRenderer); renderer.Render(md); ```

claunia commented

2026-01-29 14:38:20 +00:00

@jo3w4rd commented on GitHub (Feb 8, 2022):

Great, thank you!

@jo3w4rd commented on GitHub (Feb 8, 2022): Great, thank you!

claunia referenced this issue

2026-01-29 14:49:18 +00:00

[PR #502] [MERGED] Fix CodeInline to plain text incorrect escape #1064

claunia referenced this issue

2026-01-29 14:49:19 +00:00

[PR #502] Fix CodeInline to plain text incorrect escape #1069

Sign in to join this conversation.