Markdown is actually not _that_ extensible

This came about from a hot take mentioned at IndieWebClub by Luna. Sure, markdown is extensible but it is quite bad with extensibility.

I used to think you can write HTML in Markdown but it doesn't quite work well in that the hybrid of HTML and Markdown are quite bad. For example when writing a figure, the figcaption in the below directive no longer supports markdown or HTML. So this doesn't quite work for adding links to captions or making text italics.

:::figure{.full-bleed}
![Alt text!!](./20250425-1.png)
:figcaption[My figcaption works]
:::

This is similarly limiting in Markdoc, which is a super-set of Markdown which I use for my website.

{% figure src="./20220202-3.png" alt="" caption="Make this a figcaption." /%}

This is why I want to write all my documents using typst, which has a good set of tools for diagrams, layouts, exporting to PDF, and is quite fast.