Escape HTML entities in doc comments

[oprypin]

The intention is to show their original form, but they get interpreted as HTML and the docs look weird/wrong:
https://crystal-lang.org/api/0.35.1/HTML.html#unescape(string:String):String-class-method

[Sija]

Shouldn't they be escaped by the doc generator instead?
Injecting html anywhere in the docs sounds like a bad idea.

[oprypin]

Markdown natively has a fallback to HTML.
HTML entities are part of Markdown, you can use that on GitHub too.

© ©

Inside code tags, though, that is not the case, that is indeed a bug.

>>> import markdown
>>> m = markdown.Markdown()
>>> m.convert('''©''')
'<p>&copy;</p>'
>>> m.convert('''`&copy;`''')
'<p><code>&amp;copy;</code></p>'
>>> m.convert('''    &copy;''')
'<pre><code>&amp;copy;\n</code></pre>'