Shortcodes

Shortcodes are special blocks in your markdown that create layouts and components beyond what standard markdown offers — grids, galleries, hero images, and more. They use ::: block syntax.

:::grid 2
Column one content.
+++
Column two content.
:::

Arity rule for nesting#

When one shortcode lives inside another, the inner fence uses more colons than the outer. A :::grid (3 colons) contains ::::buttons (4 colons); a ::::buttons could contain :::::callout (5 colons), and so on. The bare close of each fence must match its opener exactly.

:::grid 2 2:3 {.hero-split}
# Pitch deck

::::buttons {.inverted}
[Download PDF](https://example.com/deck.pdf)
[Request intro](mailto:[email protected])
::::
---
Contact info
:::

Existing pages that never nested fences continue to work unchanged.

Shortcodes#