[@layout]: ../docs.layout.md
[@docs-items]: ../docs.components.md

# Authoring

Write pages in Markdown, connect them with links, and divide longer material into
Blocks that work in reading, Focus, and Slides. Start with Sources and Blocks;
add richer behavior when your content calls for it.

- [Sources](./sources.reference.md) — name a page and give it a role in your site.
- [Generate Sources](./generate.reference) — create pages from templates and JSON or CSV data.
- [Blocks](./blocks.reference.md) — keep an idea, example, and result together.
- [Markdown](./markdown.reference.md) — write text, lists, tables, and extended syntax.
- [Links](./links.reference.md) — connect pages, include content, and choose link treatments.
- [Reuse content](./reuse-content.guide.md) — include shared instructions with a real owner and consumers.
- [Opening Sources](./source-opening.guide.md) — open related content alongside the current page.

---

## Authoring reference

Media, forms, queries, and components build on those same files and links.
[Player](../learning/player.reference.md) explains how to present what you author.

```query
from: .
type: reference
sort:
  - by: meta.title
component: doc-item
```