Write content

Create documentation pages using MDX
View as Markdown

Documentation pages are written in MDX, which combines Markdown with React components. Create .mdx files in the docs/pages/ directory and reference them in your docs.yml navigation.

Basic page structure

docs/pages/my-page.mdx
---
title: Page title
subtitle: Optional subtitle
slug: my-page
---
Your content here. Use standard Markdown formatting like **bold**, *italic*, and `code`.
## Headings
Use headings to organize your content.

Using components

Fern provides built-in components for common documentation patterns:

Highlight important information with callouts.

Markdown
<Note>
Highlight important information with callouts.
</Note>
<CardGroup cols={2}>
<Card title="First card" href="/page-one">
Card description
</Card>
<Card title="Second card" href="/page-two">
Another description
</Card>
</CardGroup>