dokk

Components

Components are written as directives: a fence of colons, a name, an optional [title] and optional {key="value"} attributes. They become static HTML at build time, with no JavaScript needed to show them.

:::note[A title]
Any **Markdown** inside.
:::

Block components use three colons and a closing fence. One-line components, like link buttons, use two. Inline ones, like badges, use one. To put a component inside another, give the outer fence more colons. An unknown name fails the build with the file and line number.

Callouts

Notes, tips, cautions and warnings.

Tabs

Alternatives side by side, synced across pages.

Cards

A grid of cards, optionally linked.

Steps

A numbered sequence of steps.

Details

A collapsible block.

File tree

A folder structure from a bulleted list.

Link buttons

Links styled as buttons.

Badges, keys and colors

Inline badges, keyboard keys and color swatches.

Image

An image that opens full size when clicked.

Install

pip, uv and poetry commands for a package, as tabs.

Environment variables

A table of settings from .env lines, with Copy .env.

AI components

Model cards, chats, tools, agent traces, prompts and benchmarks.

Custom components

Add a template to register your own.