Built with WordPress, hosted on Fastly behind Cloudflare. Domain registered in 2026.
polytypo.dev is built with WordPress, hosted on Fastly behind Cloudflare. It measures traffic with Umami.
| Technology | Version | First seen |
|---|---|---|
| CMS & Site Builders1 | ||
| – | 9 Nov 2026 | |
| WordPress Plugins1 | ||
| – | 9 Nov 2026 | |
| Web Servers, Languages & Backend Frameworks1 | ||
| – | 9 Nov 2026 | |
| CDN & Hosting4 | ||
| – | 9 Nov 2026 | |
| Analytics & Tag Management1 | ||
| – | 9 Nov 2026 | |
Registration from the registry's RDAP record, the certificate the site serves, and its rank in public traffic lists.
The crew hasn’t read this site’s colors yet. We read a palette when we capture a site’s screenshot, busiest sites first. Meanwhile, browse palettes from other sites.
Counted from every stack change we've recorded: of the sites we watched running one of this site's tools, how many went on to add another. A pattern across sites, not a forecast for this one.
route2.mx.cloudflare.netroute3.mx.cloudflare.netroute1.mx.cloudflare.netaragorn.ns.cloudflare.commagnolia.ns.cloudflare.comgoogle-site-verification=s6-klz0Hcdni4dp1mFuuTwcgqXZ0I2B-uSJFl2JkSGMv=spf1 include:_spf.mx.cloudflare.net ~allUser-agent: * Allow: / Sitemap: https://polytypo.dev/sitemap.xml
# polytypo
> Locale-correct quotes, dashes, ellipses, hyphens and no-break spaces. One portable spec, five runtime implementations, byte-identical output — transform(input, { locale }) is pure, with no I/O, network access or global state.
polytypo is a typography rules engine, not a grammar or spell checker: it normalizes punctuation and spacing to the convention of a specific locale, and every rule cites its normative source (Chicago/Oxford, Duden, Imprimerie nationale, Kotus, Språkrådet, Мильчин). Spec 1.20.1, 27 locales (bg, hr, cs, nl, en-GB, en-US, fi, fr-CA, fr, de-DE, de-CH, el, hu, it, lt, pl, pt-BR, pt-PT, ro, ru, sr, sk, sl, es, sv, tr, uk), rules run in this fixed order: spaces, ellipsis, ranges, dashes, hyphen, quotes, apostrophe, symbols, nbsp.
Modes (4): text, html, markdown, yaml. `text` has no parser and no skip list — the whole string is prose to it. `html` and `markdown` parse the document and run the rules only on prose text nodes, never inside tags, attributes, character references, code spans or code blocks; `markdown` additionally requires an explicit `dialect` ("commonmark" or "mdx"), which is never detected, because one autolink is valid CommonMark and a parse error in MDX. `yaml` uses no parser either and is the one mode that skips by default: it processes only the values of the mapping keys named in its required `keys` option, which has no default, because nothing in YAML's syntax separates a prose `description:` from a shell command in `run:`. Whatever a mode does not process comes back byte for byte.
## Docs
- [Reference](https://polytypo.dev/docs/): API shape, options, the full error code contract, code examples for all five runtimes.
- [Installation](https://polytypo.dev/docs/getting-started/installation/): Install polytypo for JavaScript, Python, Go, Ruby or PHP and make a first call.
- [Choosing a mode](https://polytypo.dev/docs/getting-started/choosing-a-mode/): Which mode to call for which input, and what goes wrong when a string is passed to the wrong one.
- [transform](https://polytypo.dev/docs/api/transform/): The one function polytypo is built around: its signature in all five runtimes, what it returns, what it throws, and the purity it guarantees.
- [Options](https://polytypo.dev/docs/api/options/): Every polytypo option, its type and default, what it requires, and which error an invalid value raises.
- [analyze](https://polytypo.dev/docs/api/analyze/): The same pipeline as transform, reporting what it would change instead of changing it, with code-point offsets into your input.
- [Error codes](https://polytypo.dev/docs/api/errors/): The eight stable polytypo error codes, when each is thrown, and why the code, not the message, is the contract.
- [How modes work](https://polytypo.dev/docs/modes/overview/): Why polytypo has modes, what the rules are allowed to see in each, and the three guarantees all four share.
- [Text mode](https://polytypo.dev/docs/modes/text/): The default mode. The whole string is prose, there is no parser and no skip list, so everything in it is typeset.
- [HTML mode](https://polytypo.dev/docs/modes/html/): Typeset the prose in an HTML document or fragment while tags, attributes, code, scripts and character references come back byte for byte.
- [Markdown mode](https://polytypo.dev/docs/modes/markdown/): Typeset the prose of a CommonMark or MDX document, leaving code, links, HTML and frontmatter exactly as written.
- [Markdown dialects](https://polytypo.dev/docs/modes/markdown/dialects/): Why markdown mode requires an explicit dialect, what commonmark and mdx each mean, and what happens when the document does not parse.
- [Markdown skip list](https://polytypo.dev/docs/modes/markdown/skip-list/): Exactly which parts of a Markdown document markdown mode leaves untouched, and which parts it typesets.
- [Frontmatter](https://polytypo.dev/docs/modes/markdown/frontmatter/): How markdown mode treats a YAML or TOML frontmatter block, how to typeset named fields with frontmatterKeys, and how the block is located.
- [MDX](https://polytypo.dev/docs/modes/markdown/mdx/): How markdown mode handles MDX: JSX elements and attributes, expressions, ESM statements, and documents that fail to parse.
- [YAML mode](https://polytypo.dev/docs/modes/yaml/): Typeset the prose values of named keys in a YAML file, with a specified scan instead of a parser, and everything else returned byte for byte.
- [YAML keys](https://polytypo.dev/docs/modes/yaml/keys/): How the keys option selects values in yaml mode: exact matching, any depth, no paths or globs, and which lines the scan reads as keys.
- [Quoting and scalar forms](https://polytypo.dev/docs/modes/yaml/quoting/): Which YAML value forms yaml mode typesets, which it leaves untouched, and why a colon or hash inside a plain scalar is treated as a boundary.
- [spaces](https://polytypo.dev/docs/rules/spaces/): The spaces rule collapses runs of ordinary spaces, removes spaces before punctuation and inside brackets, and leaves indentation, hard breaks and emoticons alone.
- [ellipsis](https://polytypo.dev/docs/rules/ellipsis/): The ellipsis rule turns runs of three or more dots into the single character U+2026 and writes the two-dot form after ? and ! in locales that use it.
- [ranges](https://polytypo.dev/docs/rules/ranges/): The opt-in ranges rule turns a hyphen between two numbers into the locale's range dash, with the guards that protect dates, phone numbers and decimals.
- [Dashes](https://polytypo.dev/docs/rules/dashes/): The dashes rule sets the parenthetical dash in the form each locale prescribes, and leaves compound hyphens, numbers, ranges and arrows alone.
- [Hyphen](https://polytypo.dev/docs/rules/hyphen/): The hyphen rule binds the hyphen in listed Russian and Ukrainian forms with a non-breaking hyphen so a line break cannot split the word.
- [Quotes](https://polytypo.dev/docs/rules/quotes/): How the quotes rule turns straight and foreign quotation marks into each locale's primary and secondary pairs, resolves nesting, and leaves unmatched marks alone.
- [Apostrophe](https://polytypo.dev/docs/rules/apostrophe/): The apostrophe rule turns the straight apostrophe into U+2019 in contractions, elisions, possessives and decade abbreviations, and leaves foot marks and primes alone.
- [symbols](https://polytypo.dev/docs/rules/symbols/): The symbols rule converts (c), (r) and (tm) to the copyright, registered and trademark signs, between-number x to the multiplication sign, and +/- before a digit to a plus-minus sign.
- [No-break spaces](https://polytypo.dev/docs/rules/nbsp/): How the nbsp rule converts and inserts U+00A0 and U+202F per locale, with the ten lists it reads, the narrowNbsp option and what it leaves alone.
- [The span model](https://polytypo.dev/docs/concepts/span-model/): How html, markdown and yaml modes show the rules only the prose of a document, and why spans are joined with boundary markers instead of processed alone.
- [Round trip](https://polytypo.dev/docs/concepts/round-trip/): In html, markdown and yaml modes the output is your input with a few substring replacements applied, and nothing is re-serialised.
- [Idempotency](https://polytypo.dev/docs/concepts/idempotency/): Why transform(transform(x)) equals transform(x) is a contract in every runtime, and what it means for text that is already typeset.
- [Rule order](https://polytypo.dev/docs/concepts/rule-order/): The fixed order in which the nine polytypo rules run, why each sits where it does, why ranges is off by default, and how options never reorder them.
- [Locale resolution](https://polytypo.dev/docs/concepts/locale-resolution/): How the locale option becomes exactly one locale: exact match, alias, one region strip, and an error otherwise, never a fallback to English.
- [Invisible characters](https://polytypo.dev/docs/concepts/invisible-characters/): The four characters polytypo inserts that you cannot see, U+00A0, U+202F, U+2011 and U+2060, what inserts each, how to spot them, and the narrowNbsp option.
- [Running polytypo in a build step](https://polytypo.dev/docs/guides/build-step/): Typeset Markdown, MDX and HTML files at build time with a complete Node script, choosing locale, mode and dialect per file, with a check mode for CI.
- [Typesetting an MDX blog](https://polytypo.dev/docs/guides/mdx-content/): Process MDX posts with markdown mode and the mdx dialect, typeset frontmatter title and description, and know what is skipped, what is prose and what throws.
- [Typesetting Markdown in a remark pipeline](https://polytypo.dev/docs/guides/remark-plugin/): Add remark-polytypo to a unified, MDX or Next.js pipeline to typeset Markdown prose at build time, with the options, the plugin order and the warnings it reports.
- [Typesetting prose in YAML config](https://polytypo.dev/docs/guides/yaml-config/): Use yaml mode on OpenAPI-style and config YAML, naming the keys that hold prose, and see how quoted, plain and block scalars are handled and what is skipped.
- [JavaScript and TypeScript](https://polytypo.dev/docs/runtimes/javascript/): Install polytypo from npm, call transform and analyze in JavaScript or TypeScript, read error codes, and see which modes and dialects the package covers.
- [Python](https://polytypo.dev/docs/runtimes/python/): Install polytypo from PyPI, call transform and analyze with keyword arguments, handle PolytypoError codes, and see which modes and dialects the package covers.
- [Go](https://polytypo.dev/docs/runtimes/go/): Install polytypo for Go, call Transform and Analyze with an Options struct, check *polytypo.Error codes, and see which modes and dialects the module covers.
- [Ruby](https://polytypo.dev/docs/runtimes/ruby/): Install the polytypo gem, call Polytypo.transform and Polytypo.analyze with keyword arguments, rescue Polytypo::Error codes, and see which modes the gem covers.
- [PHP](https://polytypo.dev/docs/runtimes/php/): Install polytypo with Composer, call Polytypo::transform and Polytypo::analyze with named arguments, catch PolytypoException codes, and see which modes PHP covers.
- [Locales](https://polytypo.dev/locales/): typography rules by locale, each backed by a citation and a conformance fixture set.
- [Bulgarian (bg)](https://polytypo.dev/locales/bg/): Bulgarian (bg): quotation marks „…“ and „…“, spaced en dash for breaks; 6 cited sources, 29 tested examples.
- [Croatian (hr)](https://polytypo.dev/locales/hr/): Croatian (hr): quotation marks „…” and ‘…’, spaced en dash for breaks; 6 cited sources, 29 tested examples.
- [Czech (cs)](https://polytypo.dev/locales/cs/): Czech (cs): quotation marks „…“ and ‚…‘, spaced en dash for breaks; 8 cited sources, 19 tested examples.
- [Dutch (nl)](https://polytypo.dev/locales/nl/): Dutch (nl): quotation marks “…” and ‘…’, spaced en dash for breaks; 9 cited sources, 16 tested examples.
- [English (United Kingdom) (en-GB)](https://polytypo.dev/locales/en-GB/): English (United Kingdom) (en-GB): quotation marks ‘…’ and “…”, spaced en dash for breaks; 9 cited sources, 220 tested examples.
- [English (United States) (en-US)](https://polytypo.dev/locales/en-US/): English (United States) (en-US): quotation marks “…” and ‘…’, unspaced em dash for breaks; 11 cited sources, 470 tested examples.
- [Finnish (fi)](https://polytypo.dev/locales/fi/): Finnish (fi): quotation marks ”…” and ’…’, spaced en dash for breaks; 12 cited sources, 157 tested examples.
- [French (Canada) (fr-CA)](https://polytypo.dev/locales/fr-CA/): French (Canada) (fr-CA): quotation marks «…» and “…”, spaced em dash for breaks; 9 cited sources, 40 tested examples.
- [French (France) (fr)](https://polytypo.dev/locales/fr/): French (France) (fr): quotation marks «…» and “…”, spaced em dash for breaks; 10 cited sources, 127 tested examples.
- [German (Germany) (de-DE)](https://polytypo.dev/locales/de-DE/): German (Germany) (de-DE): quotation marks „…“ and ‚…‘, spaced en dash for breaks; 7 cited sources, 93 tested examples.
- [German (Switzerland) (de-CH)](https://polytypo.dev/locales/de-CH/): German (Switzerland) (de-CH): quotation marks «…» and ‹…›, spaced en dash for breaks; 6 cited sources, 61 tested examples.
- [Greek (el)](https://polytypo.dev/locales/el/): Greek (el): quotation marks «…» and “…”, paired em dash for breaks; 8 cited sources, 35 tested examples.
- [Hungarian (hu)](https://polytypo.dev/locales/hu/): Hungarian (hu): quotation marks „…” and »…«, spaced en dash for breaks; 7 cited sources, 30 tested examples.
- [Italian (it)](https://polytypo.dev/locales/it/): Italian (it): quotation marks «…» and “…”, spaced em dash for breaks; 10 cited sources, 21 tested examples.
- [Lithuanian (lt)](https://polytypo.dev/locales/lt/): Lithuanian (lt): quotation marks „…“ and „…“, spaced en dash for breaks; 7 cited sources, 37 tested examples.
- [Polish (pl)](https://polytypo.dev/locales/pl/): Polish (pl): quotation marks „…” and »…«, spaced en dash for breaks; 9 cited sources, 16 tested examples.
- [Portuguese (Brazil) (pt-BR)](https://polytypo.dev/locales/pt-BR/): Portuguese (Brazil) (pt-BR): quotation marks “…” and ‘…’, spaced en dash for breaks; 8 cited sources, 19 tested examples.
- [Portuguese (Portugal) (pt-PT)](https://polytypo.dev/locales/pt-PT/): Portuguese (Portugal) (pt-PT): quotation marks «…» and “…”, spaced em dash for breaks; 8 cited sources, 19 tested examples.
- [Romanian (ro)](https://polytypo.dev/locales/ro/): Romanian (ro): quotation marks „…” and «…», spaced en dash for breaks; 6 cited sources, 27 tested examples.
- [Russian (ru)](https://polytypo.dev/locales/ru/): Russian (ru): quotation marks «…» and „…“, spaced em dash for breaks; 6 cited sources, 89 tested examples.
- [Serbian (sr)](https://polytypo.dev/locales/sr/): Serbian (sr): quotation marks „…” and ’…’, spaced en dash for breaks; 6 cited sources, 24 tested examples.
- [Slovak (sk)](https://polytypo.dev/locales/sk/): Slovak (sk): quotation marks „…“ and ‚…‘, spaced en dash for breaks; 8 cited sources, 31 tested examples.
- [Slovenian (sl)](https://polytypo.dev/locales/sl/): Slovenian (sl): quotation marks »…« and ›…‹, spaced en dash for breaks; 6 cited sources, 29 tested examples.
- [Spanish (es)](https://polytypo.dev/locales/es/): Spanish (es): quotation marks «…» and “…”, paired em dash for breaks; 10 cited sources, 58 tested examples.
- [Swedish (sv)](https://polytypo.dev/locales/sv/): Swedish (sv): quotation marks ”…” and ’…’, spaced en dash for breaks; 10 cited sources, 154 tested examples.
- [Turkish (tr)](https://polytypo.dev/locales/tr/): Turkish (tr): quotation marks “…” and ‘…’, no dash substitution for breaks; 11 cited sources, 30 tested examples.
- [Ukrainian (uk)](https://polytypo.dev/locales/uk/): Ukrainian (uk): quotation marks «…» and “…”, spaced em dash for breaks; 8 cited sources, 18 tested examples.
- [Contribute](https://polytypo.dev/contribute/): add a locale or change a rule.
- [Playground](https://polytypo.dev/playground/): run the real engine on your own text in the browser.
## Packages
- [JavaScript/TypeScript](https://www.npmjs.com/package/polytypo) — source: https://github.com/polytypo/polytypo-js
- [Python](https://pypi.org/project/polytypo/) — source: https://github.com/polytypo/polytypo-python
- [Go](https://pkg.go.dev/github.com/polytypo/polytypo-go) — source: https://github.com/polytypo/polytypo-go
- [Ruby](https://rubygems.org/gems/polytypo) — source: https://github.com/polytypo/polytypo-ruby
- [PHP](https://packagist.org/packages/polytypo/polytypo) — source: https://github.com/polytypo/polytypo-php
## Spec
- [Canonical spec repo](https://github.com/polytypo/polytypo): normative rules, locale data and conformance fixtures — runtime-agnostic, MIT licensed. An implementation is "polytypo" iff it passes this suite for the spec version it claims.
- [Modes contract](https://github.com/polytypo/polytypo/blob/main/spec/rules/modes.md): the normative document behind the modes above — the span model every mode shares, the round-trip guarantee, and each mode's skip list, including the specified scan `yaml` uses in place of a parser.
- [Conformance matrix](https://github.com/polytypo/polytypo/blob/main/spec/CONFORMANCE.md): which runtime claims which spec version, and where a runtime's claimed scope is narrower than the full spec.
## Optional
- [Manifesto](https://polytypo.dev/manifesto/): why this is typography, set by locale convention long before language models existed, not an AI watermark.
- [Changelog](https://polytypo.dev/changelog/): what changed in each released spec version, with the before-and-after of every behaviour change.
- [Sites using polytypo](https://polytypo.dev/showcase/): sites that show the polytypo badge.
| – |
| 9 Nov 2026 |
| – | 9 Nov 2026 |
| – | 9 Nov 2026 |