ClearNotation

# document metadata is typed and validated
::meta{
title = "API Reference"
authors = ["Alice", "Bob"]
}

# headings always start with #
# Authentication

All requests require a +{Bearer token}.
See [the guide -> /docs/auth] for setup.

# code blocks require a language tag
```http
Authorization: Bearer <token>
```

::callout[kind="warning", title="Rate limits"]{
Requests are limited to 1000 per hour.
}

# no document metadata standard
# (YAML frontmatter varies by tool)
---
title: API Reference
authors: [Alice, Bob]
---

# headings are also used for structure
## Authentication

All requests require a **Bearer token**.
See [the guide](/docs/auth) for setup.

# language tag is optional (often omitted)
```
Authorization: Bearer <token>
```

# callouts: tool-specific, no standard
> **Warning:** Rate limits
> Requests are limited to 1000 per hour.