---
title: Writing Content
description: How to author documentation pages using MDX in Thally.
url: http://localhost:3040/pagination
---

# Writing Content

How to author documentation pages using MDX in Thally.

Every documentation page in Thally is an `.mdx` file inside `src/content/`. Each file needs frontmatter at the top with a `title` and `description`:

```mdx
---
title: My Page Title
description: A short summary for SEO and navigation.
---

Your content starts here.
```

## Markdown features

Thally supports all standard Markdown syntax plus a few extras:

| Feature | Syntax |
| --- | --- |
| Headings | `## H2`, `### H3`, `#### H4` |
| Code blocks | Fenced with language identifier |
| Tables | Pipe-delimited columns |
| Lists | Ordered and unordered |
| Links | `[text](url)` |
| Images | `![alt](src)` |

## Built-in components

Thally includes several JSX components you can use directly in MDX:

### Notes

```mdx

Informational callout with a blue accent.

```

### Code groups

```mdx

\`\`\`bash
npm install my-package
\`\`\`

\`\`\`bash
yarn add my-package
\`\`\`

```

## File organization

Pages can be nested in subdirectories. A file at `src/content/guides/setup.mdx` is referenced in `docs.json` as `"guides/setup"`.

This is example content that ships with the Thally template. Replace it with your own product documentation.