# Authoring content
Kind: article
Version: v1
Description: Write focused pages that stay useful to both people and language models.
URL: https://docs.sorrell.sh/docs/v1/authoring

## Keep the next action obvious

Start pages with the outcome a reader came for. Use headings to divide the work into steps, and keep examples close to the explanation that gives them meaning.

### Markdown first, MDX when needed

Plain Markdown is the default. MDX is available when a page needs an interactive React example or a richer content primitive. Keep those additions local to the page so the content remains portable.

### Copy for LLM

Every article places a Copy for LLM control at the top of the reading surface. The copied document includes the title, canonical URL, page context, and rendered source content in a predictable format.