Writing & Markdown

Callouts

Add NOTE, TIP, WARNING, and CAUTION callout boxes (admonitions) to highlight important information in Hugo Markdown.

Callouts (also called asides or alerts) draw attention to important information. Ownable supports GitHub-style callout syntax.

Syntax

> [!NOTE]
> Useful background information.

> [!TIP]
> Helpful advice for better results.

> [!IMPORTANT]
> Critical information the reader must know.

> [!WARNING]
> Potential issues to watch out for.

> [!CAUTION]
> High-risk actions that could cause problems.

Rendered Examples

Useful background information the reader should be aware of.

Helpful advice that can improve results or save time.

Important

Critical information the reader must know before proceeding.

Warning

Potential issues or pitfalls to watch out for.

Caution

High-risk actions that could cause data loss or other serious problems.

Callout Types

TypeUse For
NOTEBackground context, implementation details, supplementary info
TIPPerformance tips, best practices, shortcuts
IMPORTANTMust-know requirements, essential steps
WARNINGBreaking changes, compatibility issues, potential problems
CAUTIONDangerous actions, data loss risks, security concerns

Custom Titles

Add a custom title after the type:

> [!TIP] Performance Tip
> Use WebP images for 30% smaller file sizes.

Multi-line Callouts

Callouts can contain any Markdown — paragraphs, lists, code blocks:

> [!NOTE]
> This callout has multiple elements:
>
> - A list item
> - Another item
>
> ```bash
> npm install
> ```
>
> And a final paragraph.

This callout has multiple elements:

  • A list item
  • Another item
npm install

And a final paragraph.

Was this page helpful?

From the makers of

© 2026 Lore Labs.

On this page