Content authoring

Every page is a Markdown file with YAML frontmatter. The frontmatter controls the page's title, type, order, description, and relationships to other pages.

Pathways are ordered sequences of pages that guide readers through a topic. They provide their own sidebar navigation and prev/next links.

Use GitHub-style blockquote syntax to create NOTE, WARNING, IMPORTANT, TIP, and CAUTION callouts in your documentation.

Group related content into tabbed panels using HTML comment markers to present alternatives side by side.

Use Mermaid code blocks to add flowcharts, sequence diagrams, and other diagrams to your documentation.

Use the ~slug shorthand to link between pages. Trail resolves these at build time to absolute URLs.

Trail highlights code blocks at build time using Chroma with the Dracula theme. Every code block has a copy button.