chan.dev / decisions

11. Use micromark for alternates

Accepted

Context

I’ve struggled finding a markdown processor for non-Astro controlled transformations.

My needs:

Ultimately, I think that will be remark-parse. But I wanted to start with something that that was most of what I need out of the box.

Options

markdown-it is extremely simple. I used it in eleventy. And it’s recommended in the Astro: Add an RSS feed doc.

Naturally I tried to pull double duty with it. Then learned that it just isn’t rendering images at all (including in my RSS feed. problem for another day).

micromark has a lot of the features in my checklist, and first-class extensions for featurse that I use. it’s also 100% CommanMark/GFM compatable.

My understanding is that it doesn’t use an AST. So any remark knowledge kinda goes out the window. So our final destination will likely be remark-parse.

[marked][https://github.com/markedjs/marked] is massively popular but lists CommonMark and GFM support as “in progress”.

Alt text

Decision

Use micromark for alternative markdown processing.

Consequences