# cyrillic-romanization

> Convert Cyrillic characters to Latin characters (transliteration)

Latest version **1.2.3** (published 2026-09-11) · MIT license · 0 weekly downloads

## Install

```sh
npm install cyrillic-romanization
pnpm add cyrillic-romanization
yarn add cyrillic-romanization
bun add cyrillic-romanization
```

## Health

**Score 70/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; recently updated; high maintenance score; high quality score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 1.2.3 |
| Published | 2026-09-11 |
| First published | 2024-04-18 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=20 |
| Dependencies | 0 |
| Unpacked size | 28.8 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 2 |
| Author | Andrey Enin |
| Maintainers | adequatica |
| Keywords | ala-lc, alphabet, azerbaijani, belarusian, bulgarian, cyrillic, gaj, interslavic, iso9, kazakh, language, latin, macedonian, medžuslovjansky, mongolian, montenegrin, romanization, russian, serbian, transliteration, turkmen, ukrainian, uzbek |

## Links

- npm: https://www.npmjs.com/package/cyrillic-romanization
- Repository: https://github.com/adequatica/cyrillic-romanization
- Homepage: https://github.com/adequatica/cyrillic-romanization#readme
- Issues: https://github.com/adequatica/cyrillic-romanization/issues
- npm.io page: https://npm.io/package/cyrillic-romanization

## Alternatives

- [angular-pipes](https://npm.io/package/angular-pipes.md) — 5.6K weekly downloads
- [@ng-web-apis/midi](https://npm.io/package/@ng-web-apis/midi.md) — 2.6K weekly downloads
- [happn-3](https://npm.io/package/happn-3.md) — 1.6K weekly downloads
- [@opensip-cli/lang-go](https://npm.io/package/@opensip-cli/lang-go.md) — 1.2K weekly downloads
- [mongoose-typescript](https://npm.io/package/mongoose-typescript.md) — 85 weekly downloads

## Recent versions

- 1.2.3 (latest) — 2026-09-11
- 1.2.2 — 2026-07-24
- 1.2.1 — 2026-05-17
- 1.2.0 — 2026-05-17
- 1.1.8 — 2025-02-07
- 1.1.7 — 2024-10-17
- 1.1.5 — 2024-07-10
- 1.1.4 — 2024-07-09
- 1.1.3 — 2024-07-08
- 1.1.2 — 2024-04-20
- 1.1.1 — 2024-04-20
- 1.1.0 — 2024-04-19
- 1.0.0 — 2024-04-18

## README

# Cyrillic Romanization

[![Run tests](https://github.com/adequatica/cyrillic-romanization/actions/workflows/run-tests.yaml/badge.svg?branch=main)](https://github.com/adequatica/cyrillic-romanization/actions/workflows/run-tests.yaml)

Convert Cyrillic characters to Latin characters (transliteration).

Default transliteration works according to **[ISO 9:1995](https://en.wikipedia.org/wiki/ISO_9)** regardless of the language.

However, ISO 9 is rarely used in practice because it has unusual diacritical letters. Thus:

- [Gaj's Latin alphabet transliteration](https://en.wikipedia.org/wiki/Gaj%27s_Latin_alphabet) is supported for the **Serbian, Macedonian, and Montenegrin** alphabets;
- The **Azerbaijani** transliteration uses the contemporary form of the grapheme [schwa](<https://en.wikipedia.org/wiki/Schwa_(letter)>) instead of A-[diaeresis](<https://en.wikipedia.org/wiki/Diaeresis_(diacritic)>) (1992);
- The _-ia_ exception at the end of a word is supported for **Bulgarian** transliteration;
- The **Interslavic** (medžuslovjansky) transliteration is based on the [official orthography’s](http://steen.free.fr/interslavic/orthography.html) correspondence between letters.
- The **Kazakh** transliteration follows the [Decree of the President of the Republic of Kazakhstan dated October 26, 2017, No. 569](https://academy-gp.kz/?p=9661&lang=en), 2021 revision;
- The [MNS 5217:2012](https://fr.wikipedia.org/wiki/MNS_5217:2012) standard is supported for the **Mongolian** Cyrillic alphabet;
- For **Russian and Belarusian**, [GOST 7.79-2000 (B)](https://en.wikipedia.org/wiki/GOST_7.79-2000) is used;
- An additional [ALA-LC romanization](https://en.wikipedia.org/wiki/ALA-LC_romanization_for_Russian) system is supported for Russian;
- The **Turkmen** transliteration uses contemporary conventional letter symbols (1999);
- The **Ukrainian** Cyrillic alphabet is transliterated into Latin by the Ukrainian national system based on [BGN/PCGN 2019](https://en.wikipedia.org/wiki/BGN/PCGN_romanization);
- For **Uzbek** romanization, the [Latin-based alphabet](https://en.wikipedia.org/wiki/Uzbek_alphabet#Modern_Latin_alphabet) is used (proposed version from 2023).

Be aware that the presented romanization rules are unsuitable for the transliteration of geographic names.

### Installation

```
npm install cyrillic-romanization
```

### Usage

```javascript
import cyrillicToLatin from 'cyrillic-romanization';

// ISO 9 by default
cyrillicToLatin('Ћирилица је изведена из грчког унцијала');
// => Ćirilica ǰe izvedena iz grčkog unciǰala

// Convert Serbian Cyrillic alphabet to Gaj's Latin alphabet
cyrillicToLatin('Овај веб сајт користи колачиће', 'srp');
// => Ovaj veb sajt koristi kolačiće

// Convert Russian into GOST 7.79-2000 System B
cyrillicToLatin(
  'Широкая электрификация южных губерний даст мощный толчок подъёму сельского хозяйства',
  'rus',
);
// => Shirokaya elektrifikaciya yuzhnyx gubernij dast moshhnyj tolchok podʺyomu selʹskogo xozyajstva
```

#### Language parameter values

1. `iso9` — ISO 9, default (optional);
2. `alalc` — ALA-LC romanization for Russian;
3. `aze` — Azerbaijani language;
4. `bel` — Belarusian language;
5. `bul` — Bulgarian language;
6. `cnr` — Montenegrin language;
7. `isv` — Interslavic language;
8. `kaz` — Kazakh language;
9. `mkd` — Macedonian language;
10. `mon` — Mongolian language;
11. `rus` — Russian language;
12. `srp` — Serbian language;
13. `tuk` — Turkmen language;
14. `ukr` — Ukrainian language;
15. `uzb` — Uzbek language.

---
_Source: https://npm.io/package/cyrillic-romanization · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._