Skip to content Skip to footer navigation
Light theme Dark theme

Augmentation

Augmentation automatically transforms the rendered output of all Blueprint-defined variables based on their fieldtype.

Overview#

Augmentation is kind of like magic. ✨

For example, while using a Markdown field, your content will automatically be converted to HTML without needing to use a markdown modifier. Each fieldtype documents if and how augmentation affects output.

Hinty Hint!

Variables created "on the fly" with Front Matter won't be augmented.

A troll pointing a teaching stick

Example#

Let's look at an example with and without augmentation using the following content:

## How to jump higher

Bend your knees more and then spring upwards a _lot_ faster.

With augmentation#

If you're using a Markdown field, the output will be as follows:

<h2>How to Jump Higher</h2>

<p>Bend your knees more and then spring upwards a <em>lot</em> faster.</p>

Without augmentation#

While using a Textarea field — which is not augmented — the output will be exactly the same as the input:

  ## How to Jump Higher

  Bend your knees more and then spring upwards a _lot_ faster.

Digging deeper#

Learn the inner workings of Augmentation and how to take advantage of it in your own addons and extensions.