Pages
MDX pages, frontmatter fields, and how a page becomes a URL.
Pages
Every page is an .mdx file: markdown, with components
available when prose isn't enough. The file's location decides its URL —
content/docs/payments/guides/refunds.mdx serves at
/payments/guides/refunds, and index.mdx serves at its folder's path.
Frontmatter
---
title: Refunds
description: Issue full and partial refunds through the API.
icon: undo
---| Field | Required | Purpose |
|---|---|---|
title | Yes | Page heading in nav, search, tabs, and metadata |
description | — | Meta description, search snippet, generated OG image |
icon | — | A Lucide icon name attached to the page (accepted today; not yet rendered in the sidebar) |
full | — | Wider layout for content that needs the room |
noindex | — | true drops the page from sitemap and search indexing |
Markdown, plus
Standard GitHub-flavored markdown all works: headings (auto-anchored — hover
one on this page), lists, task lists, tables (styled automatically), links,
images (/images/... from public/, rendered responsively), and fenced
code blocks with syntax highlighting.
Where markdown stops, components start — callouts, tabs, steps, cards, accordions, diagrams — all usable with no imports. The gallery shows every one live.
Every page is also markdown
Append .md to any page's URL and you get its raw markdown — useful for
piping docs into AI tools, and part of what makes the site legible to
LLM-based agents alongside llms.txt.