prettier-plugin-mustache weekly downloads statistics

prettier-plugin-mustache

Prettier plugin for Mustache templates.

It formats .mustache, .mst, and .mu files with a focus on stable, idempotent output and Mustache syntax rather than Handlebars, Ember, or Glimmer extensions.

Install

Quick Start

Recommended config:

Then format templates:

Configuration Patterns

Minimal setup

Explicit override

Use this when a repository contains several template languages and you want editor format-on-save to stay predictable.

Local plugin build during dogfooding

CLI

Published package:

Local plugin build:

API

Supported File Extensions

• .mustache • .mst • .mu

What The Plugin Handles Today

| Mustache feature | Example | Status |

| Plain text templates | Hello from {Mustache}! | Preserved | | Escaped variables | {{name}} | Formatted | | Dotted names | {{user.name}} | Formatted | | Implicit iterator | {{.}} | Formatted | | Triple mustache | {{{html}}} | Formatted | | Ampersand unescaped variables | {{& html}} | Formatted | | Comments | {{! comment}} | Formatted | | Multiline comments | {{! first\nsecond }} | Preserved/formatted | | Sections | {{#items}}...{{/items}} | Formatted | | Inverted sections | {{^items}}...{{/items}} | Formatted | | Lambda sections | {{#wrapped}}...{{/wrapped}} | Syntax formatted; runtime behavior belongs to the renderer | | Partials | {{> user}} | Formatted | | Dynamic partial names | {{>*partial}} | Formatted | | Set delimiters | {{==}} | Formatted and tracked | | Delimiter reset | | Formatted and tracked | | Blocks/inheritance extension | {{$title}}...{{/title}} | Formatted | | Parent templates | {{ user}}, {{==}} | Formatted in multiline sections | | HTML with Mustache | {{name}} | Indented/formatted | | Multiline HTML tags and attributes | | Indented/formatted | | Conditional class blocks | {{#primary}}btn-primary{{/primary}} inside class="" | Indented/formatted | | Void/self-closing HTML tags | , | Preserved/formatted | | Broken/unmatched tags | {{#items}}... | Preserved raw instead of throwing | | Embedded , or a body that isn't valid JS/CSS after guarded substitution) preserve their source. • Lambda behavior, partial loading, recursive partial expansion, HTML escaping, and context lookup are runtime renderer responsibilities. • This package does not claim Handlebars compatibility. Use @poliklot/prettier-plugin-handlebars for classic Handlebars templates. • This package does not claim Ember/Glimmer compatibility.

Development

npm run check builds the plugin, runs unit/semantic/real-world-pattern tests, and runs deterministic fuzz coverage.

npm run corpus:oss clones and checks large public Mustache template corpora from Mustache.js, OpenAPI Generator, and Swagger Codegen. See OSS corpus notes.

CI runs build, tests, fuzz, pack validation, and install smoke checks on Node 18, 20, and 22.

Shared embedding work

See shared embedding architecture and cross-repository dependencies. This source work depends on the core tracking issue.

Description from the npm listing.