> Arbitrary text to add at the BEGINNING of the page

# Write content

> Create documentation pages using MDX

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`**

```markdown title="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](https://buildwithfern.com/learn/docs/writing-content/components/overview) for common documentation patterns:

> **Note**
>
> Highlight important information with callouts.

#### [First card](/editing-your-docs)

Editing your docs

#### [Second card](/customization)

Customize your docs

**`Markdown`**

```jsx 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>
```

> Create documentation pages using MDX