# Templating

Retype's templating system lets you embed dynamic content directly in your Markdown pages. Think of it as "programmable content".

Templating is powered by Scriban and requires no separate build step or configuration. Write a template expression anywhere in your content and Retype evaluates it when the page is built.

A template expression is wrapped in double curly braces. Retype evaluates the expression and replaces it with the result.

{{ page.title }}

Statements such as conditionals and loops use {{ and }} as well, with keywords like if, for, and end:

{{ if page.tags | array.size > 0 }}
Tags: {{ page.tags | array.join ", " }}
{{ end }}

To suppress a newline at the start or end of a statement block, add a tilde (~):

{{~ for item in items ~}}
- {{ item }}
{{~ end ~}}

Use {{# ... }} for comments that are stripped from output and never rendered:

{{# This comment will not appear in the output }}

Access metadata from the current page's frontmatter using page.*:

## {{ page.title }}

{{ page.description }}

_Last updated: {{ page.date }}_

See Page properties for the full property reference.

Access values from your retype.yml configuration using project.*:

© {{ date.now.year }} {{ project.branding.title }}. All rights reserved.

See Project properties for the full property reference.

Pull reusable content from another file using include. By default, Retype looks inside the _includes folder at the project root:

{{ include "contact-us" }}

Includes support parameters, nested includes, and both .md and .html file types. See Includes for details.

Use content.blog.posts to access the blog post collection. Combine array.first to get the latest entry:

{{ recent = content.blog.posts | array.first }}
Latest post: [{{ recent.title }}]({{ recent.url }})

Render it as a card with a single line:

[!card]({{ (content.blog.posts | array.first).filePath }})

See Content for querying pages, tags, categories, authors, and navigation.

Show or hide content based on page properties or project configuration:

{{ if page.tags contains "beta" }}
> [!warning]
> This feature is in beta and subject to change.
{{ end }}

Output the current year to keep copyright notices accurate without manual updates:

© {{ date.now.year }} My Company. All rights reserved.

Retype includes built-in functions for strings, arrays, dates, math, HTML, and objects. Functions can be called directly or chained with the pipe operator:

{{ page.title | string.upcase }}
{{ page.tags | array.sort | array.join ", " }}
{{ date.now | date.to_string "%B %d, %Y" }}

See Functions and filters for the full reference.