I'm writing some docs in markdown, and I'm really glad I can use arbitrary HTML when I need to. It's so handy when you hit the limits of markdown (e.g. tables, named anchors, custom styling).
It's dangerous when you have untrusted input, but I'm beginning to appreciate it.
miniblog.
Related Posts
6
Terminad is a really interesting approach to rendering markdown in the CLI. It deliberately doesn't render links, so you can always see both the link text and the URL.
In a browser you have hover to see URLs, but not necessarily in a terminal.
31
One cute feature of markdown I'd not noticed before: there's no syntax for images *without* a description (i.e. alt text).
22
Today I learnt that you can mix HTML inline in markdown! For example, the following is valid.
Foo <hr/>
I'd assumed that you needed HTML separately, like ``` blocks, but no: https://spec.commonmark.org/0.31.2/#raw-html
Admittedly HTML is very restricted on most sites, but it's helpful for SSGs.