[Kotlin/dokka] New comment by apatrida on pull request
#83: many markdown fixes
Maybe the rendering methods could change then instead to be workable for both. I had to force-fit the HTML rendering style pattern to work with Markdown.
Another option is to use html tags in the markdown, but it isn't clear which renderers support which basic tags, and if a person might have them turned off.
So these changes try to use the standard markdown language unless it would not work at all in some cases then use html tags which might be stripped (which is fine, it does best attempt).
The current model also wanted to escape things before building strings and was escaping for HTML and not for markdown, so that was a problem too.
Basically this commit represents the basic "make everything work right" at least from the renderers I checked including Github's. (likely the most common use of this is Github yes?)