Skip to content

Authoring field guide

Explore the rendered examples first, then open Show Markdown source to copy the exact input. Examples use four spaces for nested blocks, as required by Python Markdown.

Choose a pattern

Start with the content you need to explain.

Show Markdown source
<div class="grid cards" markdown>

- **[Prose and structure](prose.md)**

    Headings, lists, formatting, footnotes, tables, tooltips, and buttons.

- **[Callouts and tabs](callouts.md)**

    Notes, collapsible details, alternative paths, and cards.

- **[Code and reuse](code.md)**

    Highlighting, annotations, snippets, and the limits of directives.

- **[Visual explanations](visuals.md)**

    Diagrams, equations, images, icons, and emoji.

</div>

Focused examples

Page metadata

This page supplies a title and description in YAML front matter. The title appears in the page metadata and navigation context; the description is available to the site as page metadata.

Show Markdown source
---
title: Authoring field guide
description: Practical, rendered examples of authoring field guide.
---

References