Using Markdown Directives

Clayo articles support standard markdown plus a set of directives — special blocks that render as richer components on your docs site.

Syntax

Directives use a fenced syntax with triple colons:

:::callout{type="info"}
This is an informational callout.
:::

Each directive has a name (like callout or video) and optional attributes in curly braces.

Available directives

Callout

Highlight important information with a styled box.

:::callout{type="warning"}
Be careful when deleting a project — this action cannot be undone.
:::

Types: info, warning, success, error

Video

Embed a video from YouTube, Loom, or Vimeo.

:::video{url="https://www.youtube.com/watch?v=dQw4w9WgXcQ"}
:::

Tabs

Group related content into switchable tabs using a nested container:

::::tabs
:::tab{title="macOS"}
Install with Homebrew: `brew install clayo`
:::
:::tab{title="Linux"}
Install with apt: `sudo apt install clayo`
:::
::::

Note the four colons on the outer tabs container and three on each inner tab.

Discovering directives

Your agent can call the directives endpoint to see all supported directives and their attributes. Ask it: "What directives does Clayo support?"