Writing content with MDX

One pipeline, three surfaces

The blog you're reading, the documentation and the changelog all render from plain .mdx files with frontmatter. Add a file, and it's live — no CMS, no database.

Frontmatter

Each post declares its metadata at the top:

---
title: Writing content with MDX
description: How the blog, docs and changelog share one MDX pipeline.
date: 2026-07-04
author: The team
tags:
  - engineering
---

Code, tables, and more

The pipeline includes GitHub-flavored Markdown and syntax highlighting, so code blocks render with theme-aware colors:

export async function getBlogPosts(locale: string) {
  // reads src/content/blog/<locale>/*.mdx, newest first
}

Posts are per-locale: drop translations in src/content/blog/es/ and they appear for Spanish readers, falling back to the default language until then.