Mar 18, 2026 · 6 min read
MDX vs JSON for Portfolio Content: A Hybrid Strategy
Why blogs belong in MDX while projects are easier to manage in structured data.
Narrative content like blogs benefits from MDX because headings, code blocks, and rich linking stay expressive and maintainable.
Projects usually work better as structured JSON or TypeScript data since cards, filters, and recommendation logic rely on predictable fields.
A hybrid model gives the best authoring experience without overengineering a CMS too early.