askama

Askama (Rust Templating)

Captured 2026-07-10 (askama 0.16.0). To update: re-verify against the askama book + docs.rs/askama, then diff for changes.

Askama is a compile-time, Jinja-like template engine for Rust. Templates are parsed at build time and generate type-checked Rust code. This skill targets the unified askama crate, version 0.16.x (MSRV 1.88, raised in 0.15.0 from 1.83; was 1.81 through 0.13.x, then 1.83 in 0.14.0). Anything older than 0.13 wired web frameworks through dedicated askama_* crates that no longer exist; see the breaking-changes section if migrating.

Quick history: Askama was forked into rinja in 2024, then the two projects re-unified as askama in early 2025. If the user mentions rinja or rinja_axum, those are deprecated. Migrate to askama / askama_web.

---

1. Current State & Setup

Cargo.toml

[dependencies]
askama = "0.16"
# For web frameworks, ADD askama_web separately (see §3):
askama_web = { version = "0.16", features = ["axum-0.8"] }

Do not depend on askama_axum, askama_actix, askama_warp, or askama_rocket (deprecated when 0.13 unified them), nor askama_gotham / askama_tide (never deprecated; just abandoned since 2023 on askama ^0.12). All dead now. There is no askama_actix_web crate.

Minimal Example

templates/hello.html:

Hello, {{ name }}!

use askama::Template;

#[derive(Template)]
#[template(path = "hello.html")]
struct HelloTemplate<'a> { name: &'a str }

HelloTemplate { name: "world" }.render()? // -> Result<String, askama::Error>

Templates live in templates/ at the crate root (next to Cargo.toml) by default. Override via askama.toml (see §11).

---

2. Rendering API: Use the Right Method

Prefer these over .to_string() or format!(), which route through a vtable at runtime and run 100-200% slower:

Method	Output	When to use
tmpl.render()	Result<String, askama::Error>	Default. Allocates a new String.
tmpl.render_into(&mut writer)	writes into impl fmt::Write	Reusing a buffer, nested rendering.
tmpl.write_into(&mut writer)	writes into impl io::Write	Writing directly to a socket / file.