DSL-wise, I've rather enjoyed Clojure's Hiccup [1].
Looking up elements that support no closing tag:
html, head, body, p, li, dt, dd, option, thead, th, tbody, tr, td, tfoot, colgroup
Makes sense if you think about it. Basically everything is pretty well defined and its obvious what next tag should close the context. <td> for example obviously ends when you come across another <td>, another <tr>, or the required </table>
Only a madman would nest tables!!
/me crying in 2000's web design.
<table>
<tr>
<td>
<table>
<tr>
<td> table-cell-inside-table
</table>
</table>Took me a long time to train myself out of <br/> afterwards though.
But the optional-style works I think for writing. Especially if you're just writing a document. If you don't have site-menus, a search bar, social-media sharing icons, javascript libraries and all the other paraphenalia and page-furniture of a website, then you are left with a lean and structured file.
It is a valid short form of <br></br>
https://developer.mozilla.org/en-US/docs/Web/HTML/Element/br
so it should be <br> on its own or <br />
<img src="img.png" height="100px">
(also the other parameter is set to "auto" automatically, at least in Firefox)
the width will be set to match the aspect ratio but your browser will have to DL the image first. which probably doesn't matter unless you have content to the left/right of it, then it'll get bumped when the image loads. layout shift is a nasty thing.
but i'm not sure if i understand the question...
https://mtsknn.fi/blog/how-to-remember-markdowns-link-syntax...
Think of it as a function call (mnemonically, it doesn't need to make sense conceptually).
The [ and ] are ascii art for a button - in between goes what is clickable (title) and then comes the url.
> I can never remember which brackets to use
and that is patently untrue, as you just demonstrated.
As for TOC, I've never written anything that strictly needs one. I do have "hxtoc" on my laptop, but I've never needed it.
I do publish some of my writing to my website, and I discuss the minimal tooling I use here: https://brett.coulstock.id.au/site-colophon.html
I struggled with Markdown (and various other mark up formats) for a long time, until I realised that, for me, nothing beats plain HTML for simplicity and expressive power.
I now use HTML the way people generally use markdown: as an open, easy to read, easy to write, plain-text format for taking notes, writing articles, expressing thoughts, and so on.
I didn't really choose HTML, I just sort of noticed that I was using it. It seems like an unconscious decision, like a river flowing downhill, finding its own path.
Most used tag would be <p>, because I write a lot of essays and things with paragraphing. As well as other structural elements such as headings and lists, I lean into <time>, <cite>, <abbr> a lot.
I tend to use the 'optional' form. I don't close <p>'s and <li>'s unless required.