Guide

Locale files

Host one markdown file per locale and bind only the locale key each file owns — no fallbacks.

The library does not own template files. Hosts pick one markdown file per locale (en/, es/).

Bind locale keys per file

Bind only the locale key that the file owns:

  • English file: {{ data.sheet.tradeName.en }}
  • Spanish file: {{ data.sheet.tradeName.es }}

Do not write || locale fallbacks. A missing value renders empty.

Avoid KV and meta locale tricks

  • Do not use ::kv. Write labels in the locale file.
  • Use ::include only for a stored markdown string.
  • Do not use [meta.locale].
Copyright © 2026