Add newline <br /> linebreak support about docfxmarkdowngen

[Jan0660]

Implemented some options and <br/> in v0.4.0 to get what you want.

[Jan0660]

The problem in this specific case seems to be that the Docusaurus' markdown does not supported ordered lists like 1),2), while using 1.,2. does work:

    /// <summary>
    /// Also does nothing.
    /// 1) 1
    /// 2) 2
    /// 
    /// but:
    /// 1. 1
    /// 2. 2
    /// </summary>

The problem with forcing a newline on every newline in the xmldoc would be that a sentence split across multiple lines in the xmldoc would then also be split over multiple lines.

I guess some options like forcing a newline always or only when the line ends with a specific character could be implemented.

[andy0x10]

True true, but I didn't just mean for lists, I meant for line breaks in general. Like if my documentation says:

This is a statement.
This is another statement.
Here is a separate statement.

Let's pretend that in this case the formating is important..

In docfx it renders as written above, but in Docusaurus that will render as:

This is a statement. This is another statement. Here is a separate statement.

I think with code comments the original intended formating should be preserved...

But now actually as I write this, I'm no longer sure 🤣 ... Feel free to close this issue, just wanted to explain my thought process...

[andy0x10]

This is great! Seems to be working!