Callouts / Admonitions

Callouts are visually distinct blocks that draw attention to a specific point. They work inside blog posts and documentation pages, as well as in PDF exports.

# Available types

# Basic syntax

:::tip
Callout content here.
:::

gives

With an optional title:

:::tip[Tip of the day]
Callout content here.
:::

gives

# Full examples

:::tip
Use Laravel helpers like `Str::slug()` to generate clean slugs.
:::

:::info[Update]
The package now supports PHP 8.4 and Laravel 12.
:::

:::danger
Never expose production credentials in seeders.
:::

:::caution[Caution]
This feature is deprecated since v2.3. Migrate to the new API.
:::

gives

# Markdown inside callouts

Callouts support all standard Markdown:

:::tip
- Lists
- **bold**, *italic*, `code`
- [links](https://example.com)

   ```php
   echo "Code too";
   ```
:::

gives

# Inserting in the editor

The Markdown editor does not include a dedicated toolbar button for callouts. But BlogR brings its own version, so you can easily insert callouts by using one of the four dedicated buttons.

# Rendering

Rendering is identical in web pages and PDF exports.