Shoalrun documentation framework
For agents
Start with https://www.shoalrun.com/llms.txt for the documentation index, then read the Markdown pages it links. Skip to article. Documentation index. Read this page as Markdown.
Reference

Action links

Give a next step a prominent link style while retaining real navigation semantics.

Updated
Read as Markdown

<ActionLink> styles a navigation link as a prominent action. <Button> is an alias for authors migrating button-like links. Both render a real <a> element, so they work with keyboard navigation and without JavaScript.

<ActionLink doc="guide.add-page">Create a page</ActionLink>
<ActionLink href="https://example.com/download" variant="secondary">Download example</ActionLink>

Create a page Download example

Attribute Required Meaning
doc or href Yes, one A stable document ID, site path, fragment, HTTP(S) URL, or mailto: link.
variant No primary (default) or secondary.

The body is nonempty inline text, with optional emphasis or inline code.

HTML, Markdown, and agents

HTML renders a real link with a visible focus state. Markdown retains its label and destination, resolving doc IDs to the target Markdown page. An agent can follow the destination without interpreting the visual button style.