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.

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

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 as 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.

Docs feedback

Submit improvements, related content, or suggestions through Github.

Betterify this page →