MDX Basics

cmdocs uses MDX — a format that lets you use JSX components inside Markdown documents.

Markdown Features

All standard Markdown features are supported:

# Heading 1
## Heading 2
### Heading 3

Headings automatically generate anchor links and appear in the table of contents.

**Bold text**
*Italic text*
~~Strikethrough~~
`inline code`

[External link](https://example.com)
[Internal link](/documentation/quickstart)

- Unordered item
- Another item
  - Nested item

1. Ordered item
2. Another item

> This is a blockquote.
> It can span multiple lines.

Use triple backticks with a language identifier for syntax highlighting:

```typescript
function greet(name: string): string {
  return `Hello, ${name}!`;
}
```

Supported languages include: typescript, javascript, python, rust, go, bash, json, yaml, css, html, and many more.

| Column 1 | Column 2 | Column 3 |
|----------|----------|----------|
| Cell 1   | Cell 2   | Cell 3   |
| Cell 4   | Cell 5   | Cell 6   |

![Alt text](/images/screenshot.png)

Place images in the public/ directory and reference them with an absolute path.

The power of MDX is using React components directly in your content. cmdocs auto-imports all built-in components — just use them:

<Callout type="info">
  This is an informational callout.
</Callout>

See the Components page for all available components.

Every MDX file starts with a YAML frontmatter block:

---
title: Page Title
description: A brief description of this page.
---

# Your content here

See Frontmatter Reference for all supported fields.