Skip to content
Only 2 spots left this month
Back to info
Content systemsReading time: 5 minPublished: Nov 17, 2025

MDX vs CMS: When Content Should Live in Code

A practical framework for deciding whether editorial or marketing content belongs in MDX files or in a content management system.

The content system should fit the team

There is no universal winner between MDX and a CMS. The right answer depends on who publishes, how often content changes, and how tightly the content needs to interact with custom components.

MDX is strong when content and design are linked

For editorial pages, case studies, technical notes, and highly art-directed content, MDX gives the development team control over structure and presentation. Content can live beside the code, which makes versioning, review, and deployment simpler.

CMS tools are better for operational publishing

If a marketing team needs to create, edit, and schedule content weekly without developer help, a CMS is the better fit. The editing workflow matters more than the purity of the stack.

Consider the hidden cost of flexibility

A CMS can create freedom, but it can also create inconsistent layouts, weak content governance, and heavier frontends if the schema is poorly planned. MDX can create control, but it may slow down publishing if every change requires a code review.

Our default rule

If the content needs custom components and changes intentionally, we prefer MDX. If the content needs operational speed, we reach for a CMS.

The question is not which tool is more modern. The question is which system preserves quality without slowing the business down.