Skip to content

Authoring with MDX

Sample MDX article showing allowlisted Astro components inside content collections.

This fixture demonstrates MDX in the articles collection. Prefer plain Markdown when components are unnecessary.

When to use MDX

  • Reusable callouts, figures, or structured blocks
  • Light composition that Markdown cannot express cleanly
  • Content authored by trusted repository contributors