On: Don’t Use Markdown for Documentation (2016)

[jitl]

I use HTML <table> in my markdown. Works great. Many already know the syntax. Supports large table cell bodies in a readable manner.

The downside is the syntax is noisy compared to your average markdown, and the tables don’t make much sense in text view.

[fnayr → jitl]

Ah yes I hadn't really thought about that for some reason. Do you view HTML as something that should only be used where necessary in MD or just go crazy with it?

[jitl → fnayr]

I use it when it’s needed:

1. Tables

2. Collapsable sections with <detail>

3. Color-coding with <span style=“...”> or <span class=“...”>