Documentation

MDX Content Guide

Author pages with frontmatter, Markdown, and approved platform components.

MDX content files live under content/pages. The file path becomes the route, so this page renders at /docs/mdx-content.

Allowed components

Use Callout, FeatureGrid, FeatureCard, ActionLink, Cluster, Stack, Surface, and approved chart components for richer content blocks.

Authoring rules

  • Include title and description in frontmatter.
  • Use layout: article for documentation pages.
  • Use layout: landing for wider marketing or overview content.
  • Keep custom components inside the approved component list.

Chart embeds

Use row or slice adapter components when chart data comes from MDX or a CMS payload. Numeric strings are converted to numbers, and malformed rows fail validation before rendering.