Spintax documentation — syntax reference, guides, playground

Start here

Syntax Reference

Complete reference for all spintax markup: enumerations, permutations, variables, includes, comments, and post-processing.

What is Spintax?

What spintax is, where it came from, and how AI changes everything about template-based content generation.

Nested Spintax

Deep-dive into nesting: arbitrary depth, cross-element composition, and the innermost-first resolution model.

Authoring guides

Reverse authoring mindset

Write the final text first. Add spintax markup last. The mental model that makes every template readable.

Variables & multi-site reuse

How variables turn one template into many sites without footprint. Precedence, reroll gotchas, separator collisions.

Permutations in practice

From simple lists to title-style serial headings. Separator rules, clamping, and the per-element override.

Grammar-safe synonymization

Keep every resolved variant readable. Binding rules for English agreement — and a full Russian-cases section in the RU version.

Template composition

Variables as already-rendered HTML chunks. The three-level item → section → orchestrator pipeline that handles real-world catalogues, payment pages, and feature lists.

Conditional spintax

The {?VAR?then|else} pre-pass for value-driven branching. Three forms, truthy rules, two-pass pipeline, and why it is not a random pick.

Plural agreement

Pick the correct grammatical noun form by count: 1 язык, 2 языка, 5 языков. RU/UK/BE and SR/HR/BS 3-form, EN-style 2-form. The first spintax engine to ship plurals as a first-class primitive.

Engines & packages

Spintax for JavaScript

The open-source @spintax/core engine on npm. Parse, render, validate spintax on Cloudflare Workers, Node, and in the browser. Zero deps, MIT, parity-verified against the WordPress plugin.

Spintax for PHP

The open-source spintax/core engine on Packagist. Conditionals, plural agreement and safe includes — not just {a|b|c}. Zero deps, MIT, PHP 8.0+, bound to the same cross-engine corpus.

Spintax engines — the family

One syntax, four independent engines — JavaScript, PHP, Python and Object Pascal — held to one shared golden corpus. Pick by runtime; install, quick start and where they differ.

Documentation