Skip to content Skip to footer navigation

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.