***
title: Write content
subtitle: Create documentation pages using MDX
slug: writing-content
---------------------
For clean Markdown of any page, append .md to the page URL. For a complete documentation index, see https://docs.getply.com/llms.txt. For full documentation content, see https://docs.getply.com/llms-full.txt.
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
```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:
Highlight important information with callouts.
Card description
Another description
```jsx Markdown
Highlight important information with callouts.
Card description
Another description
```