[@layout]: ./docs.layout.md

# PathMX docs

Build interactive websites from Markdown and HTML. Start with a page, connect it
to others, then add layouts, presentations, forms, or your own Plugins.

- [Create your first site](./start/first-site.guide.md) — install a project, edit a page, and see it update.
- [Explore examples](../examples/index.md) — try a bookcase, a lesson, and playable chess, then read their Sources.
- [Write a Plugin](./extend/plugins.guide.md) — add a working reading-time component to your site.
- [Work with an agent](./agents/index.md) — discover content, read Markdown, and verify edits.

---

## Build and publish

- [Start](./start/index.md) — installation, a workshop tutorial, project structure, and publishing.
- [Authoring](./authoring/index.md) — pages, links, media, reusable components, and forms.
- [Shape a site](./site/index.md) — shared layouts, navigation, themes, and discovery.
- [Learning experiences](./learning/index.md) — focused reading, slides, lessons, and progress.
- [Accounts and attachments](./accounts/index.md) — sign-in, personal participation, and uploads.
- [Hosting](./hosting/index.md) — static publishing or an existing writable server.

---

## Extend and look things up

- [Extend PathMX](./extend/index.md) — configure packages and build domain components, Actions, and hosts.
- [Packages](./packages.reference.md) — choose and activate optional capabilities.
- [CLI](./cli.reference.md) — project commands, options, diagnostics, and recovery.
- [Methodology](./methodology.md) — the ideas behind typed files and ordinary links.