Why this matters
MDX is useful for interactive examples, but too much component logic inside content makes editing slower and less predictable.
Setup
Use Markdown for normal articles and reserve MDX for posts that need custom tables, demos, calculators, or reusable callout components.
Implementation notes
Keep component APIs simple. A content editor should understand what a component does by reading its props, not by opening the implementation.
Final checklist
- MDX is used only when needed
- Components have clear props
- Plain Markdown remains the default