Render markdown files as markdown

[QuinnWilton]

Markdown files are rendered as their raw contents: https://preview.hex.pm/preview/ecto/3.5.6/README.md

Seeing the raw contents is helpful for review, but it may also be worthwhile to expose the option of switching to a preview of the rendered output. There's not currently any UI allowances for options like this, which is likely the main blocker for making progress on this feature.

[supersimple]

I like the idea of being able to preview the markdown files. We already have a library to handle that (earmark)

One consideration is that I would like to see the actual code whenever possible to be as transparent as possible when auditing code. One example might be a pixel image that isn't visible, but makes a call back to homebase.

I think having a UI option to preview the markdown files would be great

[wojtekmach]

There are security considerations around rendering user-generated content as HTML, Earmark should be already handling that well but I'd hold off on this for a while after all.

[ericmj]

I think having a UI option to preview the markdown files would be great

👍

There are security considerations around rendering user-generated content as HTML, Earmark should be already handling that well but I'd hold off on this for a while after all.

Last time I checked earmark allowed any HTML and we need to be more conservative to avoid XSS and such.