[mzl]

MDX as a middle ground with most of the text standard markdown and the escape hatch of custom React JSX when needed has worked well for me.

[josephg]

MDX advertises itself as "markdown + components", but its not commonmark compatible. I tried using it a few years ago. In the process, I migrated over some regular markdown documents and they render incorrectly using MDX.

I filed a bug (this was a few years ago) and I was told commonmark compatibility was an explicit non goal for the project. Meh.

[mzl]

I didn't know that, that is unfortunate to hear.