Skip to navigation

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>