--- title: "Templates" description: "Nunjucks layouts, built-in filters, and template variables." --- Simple Engine uses [Nunjucks](https://mozilla.github.io/nunjucks/) for templating. ## Basics ```html {{ title }} - {{ site.title }} {% block content %}{% endblock %} ``` Layouts typically extend a shared base: ```html {% extends "base.njk" %} {% block content %}

{{ title }}

{{ content | safe }}
{% endblock %} ``` ## Built-in filters ```html {{ date | date('MMMM d, yyyy') }} {{ content | safe }} {{ text | upper }} {{ text | lower }} {{ text | excerpt(150) }} {{ posts | limit(5) }} ``` The `date` filter also accepts `'now'` for the current date (handy in footers). ## Available variables | Variable | Meaning | |---|---| | `site.*` | Values from `simple.config.js` | | `title`, `date`, `tags`, … | Page frontmatter | | `content` | Rendered HTML from Markdown | | `page.url`, `page.path` | Current page info | | `pages` | All pages | | `collections` | Named collections (e.g. `collections.posts`) | | `seo.*` | Canonical URL, JSON-LD, and related SEO data | ## Example post layout `layouts/post.njk`: ```html {% extends "base.njk" %} {% block content %}

{{ title }}

{{ content | safe }}
{% if tags %} {% endif %}
{% endblock %} ``` ## Custom filters You can add filters from a Node script using the engine API: ```js import { SimpleEngine } from 'simple-engine'; const engine = new SimpleEngine('./'); engine.template.addFilter('reverse', (str) => { return str.split('').reverse().join(''); }); ```