mzl parent
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.
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.
I didn't know that, that is unfortunate to hear.