Button Base

button_base renders one button-style element using the shared button macro. Use it for inline actions inside documentation pages, compact CTAs, or custom Markdown sections.

When to Use

Use button_base when you need one action and do not need a full CTA section. It can render as an <a> when href is provided or as a button-style element when it is not.

Usage

{{ button_base(
text="Open documentation",
href="/docs/",
variant="solid",
color="neutral",
icon_right="arrow-right"
) }}

Live Example

Open documentation

Parameters

Parameter	Description
`text`	Button label. Required.
`href`	Optional URL. When present, the shortcode renders a link.
`target`	Optional link target, such as `_blank`.
`variant`	Visual style: `solid`, `outline`, or `ghost`.
`color`	Semantic color: `neutral`, `info`, `success`, `warning`, or `error`.
`size`	Button size: `sm`, `md`, or `lg`.
`icon`	Optional icon rendered before the label.
`icon_right`	Optional icon rendered after the label.
`radius`	Border radius: `sm`, `md`, `lg`, or `full`.
`wide`	Set to `true` to make the button full width.
`disabled`	Set to `true` to disable interaction.
`type`	Button type when no `href` is provided. Defaults to `button`.
`class`	Additional CSS classes appended to the rendered element.