mdx

Legal Pages Work Better as Typed MDX

Policies become easier to maintain when dates, product names, and domains come from config instead of hard-coded prose.

1 min read
QoA Team

Legal pages often start as static markdown and slowly drift out of sync with the actual product. MDX gives us a cleaner path.

Move the unstable bits out

Product names, support emails, site URLs, and policy dates are not real article content. They are configuration data that changes independently from the prose around them.

Keep the policy body editorial

The text itself still belongs in content. Sections, bullet lists, and explanatory copy are easier to review when they live in versioned MDX files instead of inline strings in page components.

Format once, render everywhere

When dates are configured in a single place, pages can format them consistently for headers, cards, metadata, or legal notices. That removes the most common source of stale policy pages.

The side benefit

Once legal pages use the same content pipeline as blog posts, they inherit the same collection validation, markdown styling, and layout patterns. The maintenance cost drops immediately.

Share this article

Found this helpful? Share it with others!