Button Shortcode

Mon, 01 Jan 0001 00:00:00 +0000

A modern, customizable button shortcode with gradient styling, icons, and smart link handling.

Basic Usage

The above buttons are created with:

{{< button url="/contact" >}}Contact Us{{< /button >}}

{{< button url="https://example.com" new_tab="true" style="secondary" >}}Visit External Site{{< /button >}}

Style Variants

Primary (Default)

Primary Button

{{< button url="#" style="primary" >}}Primary Button{{< /button >}}

Secondary

Secondary Button

{{< button url="#" style="secondary" >}}Secondary Button{{< /button >}}

Outline

Outline Button

{{< button url="#" style="outline" >}}Outline Button{{< /button >}}

Ghost

Ghost Button

{{< button url="#" style="ghost" >}}Ghost Button{{< /button >}}

Sizes

Extra Large

{{< button url="#" size="sm" >}}Small Button{{< /button >}}
{{< button url="#" size="md" >}}Medium Button{{< /button >}}
{{< button url="#" size="lg" >}}Large Button{{< /button >}}
{{< button url="#" size="xl" >}}Extra Large{{< /button >}}

Alignment

Left (Default)

Left Aligned

Center

Center Aligned

Right

Right Aligned

{{< button url="#" align="left" >}}Left Aligned{{< /button >}}
{{< button url="#" align="center" >}}Center Aligned{{< /button >}}
{{< button url="#" align="right" >}}Right Aligned{{< /button >}}

With Icons

Icon Before Text

download Download

Icon After Text

Continue

{{< button url="#" icon="download" >}}Download{{< /button >}}
{{< button url="#" icon="arrow-right" icon_position="right" >}}Continue{{< /button >}}

Rounded Corners

Small Radius

Medium Radius (Default)

Medium Radius

Large Radius

Pill Shape

Pill Button

{{< button url="#" rounded="sm" >}}Small Radius{{< /button >}}
{{< button url="#" rounded="md" >}}Medium Radius{{< /button >}}
{{< button url="#" rounded="lg" >}}Large Radius{{< /button >}}
{{< button url="#" rounded="full" >}}Pill Button{{< /button >}}

Advanced Examples

Call-to-Action Button

Get Started Today

{{< button url="/signup" style="primary" size="lg" align="center" icon="rocket-launch" >}}Get Started Today{{< /button >}}

External Link with New Tab

View on GitHub

{{< button url="https://github.com/hugo-blox/hugo-blox-builder" new_tab="true" style="outline" icon="arrow-top-right-on-square" icon_position="right" >}}View on GitHub{{< /button >}}

Download Button

Download PDF

{{< button url="/files/document.pdf" style="secondary" icon="document-arrow-down" rounded="full" >}}Download PDF{{< /button >}}

Parameters

Parameter	Type	Default	Description
`url`	string	`#`	Required. Button destination URL (internal or external)
`text`	string	Inner content	Button text (overrides shortcode content)
`new_tab`	boolean	`false`	Whether to open link in new tab
`style`	string	`primary`	Button style: `primary`, `secondary`, `outline`, `ghost`
`size`	string	`md`	Button size: `sm`, `md`, `lg`, `xl`
`align`	string	`left`	Button alignment: `left`, `center`, `right`
`icon`	string	-	Icon name from
`icon_position`	string	`left`	Icon position: `left`, `right`
`rounded`	string	`md`	Border radius: `sm`, `md`, `lg`, `xl`, `full`
`disabled`	boolean	`false`	Whether button should be disabled

Security Features

The button shortcode automatically handles security for external links:

External links get rel="noreferrer" attribute
External links opening in new tab get rel="noopener noreferrer"
Internal links opening in new tab get rel="noopener"

This ensures safe navigation while maintaining functionality.

Accessibility

The button shortcode includes built-in accessibility features:

Proper role="button" attribute
aria-label support
Keyboard focus indicators
High contrast focus rings
Disabled state handling

Callout Shortcode

Mon, 01 Jan 0001 00:00:00 +0000

Hugo Blox supports a Markdown extension for callouts, also referred to as alerts or asides.

Callouts are a useful feature to draw attention to important or related content such as notes, hints, or warnings in your articles.

Usage

Notes

Note

A Markdown callout is useful for displaying notices, hints, or definitions to your readers.

> [!NOTE]
> A Markdown callout is useful for displaying notices, hints, or definitions to your readers.

Warnings

Warning

Here’s some important information…

> [!WARNING]
> Here's some important information...

Cards Shortcode

Mon, 01 Jan 0001 00:00:00 +0000

A Hugo extension to create cards. Cards can be shown as links or as plain text.

Usage

Learn Shortcodes A card without an icon or link

is rendered by:

{{< cards >}}
 {{< card url="../callout" title="Callout" icon="academic-cap" >}}
 {{< card url="" title="A card without an icon" >}}
{{< /cards >}}

Options

Parameter	Description
`icon`	Name of the icon. Defaults to
`title`	Title heading for the card.
`subtitle`	Subtitle heading (supports Markdown).
`url`	URL

Spoiler

Mon, 01 Jan 0001 00:00:00 +0000

A Hugo shortcode to toggle collapsible content.

Example

Click to view the spoiler

You found me!

Markdown is supported.

Usage

{{< spoiler text="Click to view the spoiler" >}}

This is the content of the details.

Markdown is **supported**.

{{< /spoiler >}}

Steps Shortcode

Mon, 01 Jan 0001 00:00:00 +0000

Display a series of steps, such as for a tutorial.

Example

Step 1

The first step here…

Step 2

The second step here…

Step 3

The third step here…

Usage

Use the Markdown level-3 headings to represent step titles within the steps shortcode:

{{% steps %}}

### Step 1

The first step here...

### Step 2

The second step here...

### Step 3

The third step here...

{{% /steps %}}

Shortcodes |

Button Shortcode

Basic Usage

Style Variants

Primary (Default)

Secondary

Outline

Ghost

Sizes

Small

Medium (Default)

Large

Extra Large

Alignment

Left (Default)

Center

Right

With Icons

Icon Before Text

Icon After Text

Rounded Corners

Small Radius

Medium Radius (Default)

Large Radius

Pill Shape

Advanced Examples

Call-to-Action Button

External Link with New Tab

Download Button

Parameters

Security Features

Accessibility

Callout Shortcode

Usage

Notes

Warnings

Cards Shortcode

Usage

Options

Spoiler

Example

Usage

Steps Shortcode

Example

Step 1

Step 2

Step 3

Usage