Writing technical articles with plain text often feels limiting when I want to drop in interactive elements. MDX solves this by letting me write JSX directly inside Markdown files. This means I can call React components, like interactive charts or custom alert boxes, right inside a single document without jumping between files.
Within the Next.js ecosystem, I’ve made this integration much smoother using Content Layer. This approach makes writing project docs or complex technical pieces much more fluid, mostly because the workflow feels much more natural to how I actually code.
That said, MDX has its downsides too. The initial setup can be a bit of a pain. There are also integration limits if you want to use external CMS platforms like Contentful or Prismic, since Content Layer doesn't play well with them directly. But for me, it’s not a dealbreaker; I'm much more comfortable just writing straight in VSCode anyway.
Ultimately, MDX is a solid tool for technical writing, especially if you're already in the React and Next.js ecosystem. It gives you the flexibility to create living, interactive content rather than just static text. We don't always need a complex content management system; sometimes, we just need an efficient way to turn ideas into something interactive.
Give this workflow a shot!