When <para></para> tag exists before <code> tag,
Rendered HTML results is corrupted.
Example documentation comment
/// <remarks>
/// <para>
/// Dummy paragraph.
/// </para>
/// <code lang="cs">
/// public sealed class Sample
/// {
/// public int AAA {get;set;}
///
/// public int BBB {get;set;}
///
/// public int CCC {get;set;}
/// }
/// </code>
/// </remarks>
public class Sample
{
public int Dummy { get; set; }
}
Rendered Image
To Reproduce
Set documentation comment described above.
Run docfx metadata command
Run docfx build --serve command
Confirm API page for Sample class
Expected behavior<code></code> blocks are rendered as expected.
Additional context
To resolve this issue.
It need to add extra new line before <pre> tag.
That is required when embedding HTML tags on markdown text.
See https://github.com/xoofx/markdig/issues/472#issuecomment-683787240 for details
Describe the bug
When
<para></para>
tag exists before<code>
tag, Rendered HTML results is corrupted.Example documentation comment
Rendered Image
To Reproduce
docfx metadata
commanddocfx build --serve
commandExpected behavior
<code></code>
blocks are rendered as expected.Additional context To resolve this issue. It need to add
extra new line
before<pre>
tag. That is required when embedding HTML tags on markdown text.See
https://github.com/xoofx/markdig/issues/472#issuecomment-683787240
for details