Chase McCoy had a good note explaining it: https://chasem.co/2022/05/markdoc https://chasem.co/2022/05/markdoc Basically because MDX mixes JSX and markdown, yo

Chase McCoy had a good note explaining it: https://chasem.co/2022/05/markdoc https://chasem.co/2022/05/markdoc Basically because MDX mixes JSX and markdown, you need knowledge of JSX/JS (which non-devs might not have), and tooling dedicated to build, parse it and so on. Markdoc is more of a "separation of concerns" approach.