Sample guide

This sample guide exists to prove the formatting features the site relies on. The right-hand table of contents is generated automatically from the headings below.

Fenced code with syntax highlighting

Starlight ships Expressive Code, so fenced blocks are highlighted (and get a copy button) with no extra setup:

// Greet a reader by name.
function greet(name: string): string {
  return `Hello, ${name} — welcome to bytelog.`;
}

console.log(greet('world'));

# Build the site locally
npm ci
npm run build

Callouts (asides)

Use Markdown directives for callouts — no component import needed:

Note

This is a note aside. Variants include tip, caution, and danger.

Handy

You can give an aside a custom title in square brackets.

A collapsible section

Raw HTML <details> works in Markdown and renders as a native disclosure widget:

Show the long explanation

Hidden until expanded — useful for optional detail, FAQs, or long command output.

example: collapsed content can include code too

Next steps

Edit this page in the browser editor at /admin, or add a new guide alongside it — it appears in the sidebar automatically.