Перевести

Перевод документов Markdown и MDX

Документ — это не список ключей. Его текст разбросан по блокам кода, ссылкам и фронт-матеру, которые должны вернуться в точности. KAERIS разделяет файл на защищенные фрагменты и прозу, переводит только прозу и собирает фрагменты обратно.

Эту страницу перевёл KAERIS и проверил каждую строку обратным переводом. Носитель языка ещё не проверял. Оригинал на английском

Перевести ваш файл Проверить ваши файлы бесплатно

Как читается документ Markdown

Документ разрезается на скелет из литеральных фрагментов и пронумерованных текстовых сегментов. Внутри сегмента встроенный код, цели ссылок, теги HTML и JSX заменяются токенами вроде {0} перед переводом и восстанавливаются после. Модель, которая теряет один из них, вызывает тот же детектор, что и потерянная переменная.

Исходный файлgetting-started.md
---
title: Getting started
slug: getting-started
---

# Getting started

Install the package with `pip install kaeris`, then read the [CLI guide](/docs/cli).

```bash
kaeris translate en.json --langs de,ja
```

Run it once per release. It only translates new keys.

На что обратить внимание при переводе Markdown

Реальный запуск: до и после

Реальный запуск: наш тестовый документ, немецкий, 26 октября 2026 г., сокращенный до начала и одного блока кода. Заголовок, полужирный текст, команда curl и токен $TOKEN — как в исходном файле; изменились только проза и поля фронт-матера, видимые читателю.

Доhelp-returns.md
---
title: Returns and refunds
summary: How to return a record, and when you will not get a refund.
---

# Returns and refunds

You can return an unopened record within **30 days** of delivery. We refund the full price, but not the shipping cost.

…
```bash
curl https://api.example.com/v1/returns/RT-1042 -H "Authorization: Bearer $TOKEN"
```
Послеde/help-returns.md
---
title: Rücksendungen und Erstattungen
summary: So senden Sie eine Schallplatte zurück und wann Sie keine Erstattung erhalten.
---

# Rücksendungen und Erstattungen

Sie können eine ungeöffnete Schallplatte innerhalb von **30 Tagen** nach Lieferung zurücksenden. Wir erstatten den vollen Preis, jedoch nicht die Versandkosten.

…
```bash
curl https://api.example.com/v1/returns/RT-1042 -H "Authorization: Bearer $TOKEN"
```

Что KAERIS делает с этим

Перевести ваш файл Проверить ваши файлы бесплатно

Выполните в три шага

  1. Установите CLI

    Выполните pip install kaeris.

  2. Перевод документа

    Выполните kaeris translate docs/guide.md --langs de,ja. Шаблон, такой как docs/*.md, переводит несколько файлов.

  3. Прочитать обратно

    Откройте verify.json из запуска с опцией --verify, чтобы увидеть, что каждая переведенная часть теперь говорит на вашем языке.

pip install kaeris
kaeris translate docs/guide.md --langs de,ja --verify

Вопросы

Переводится ли код в моих документах?

Нет. Блоки кода, выделенные отступами или тройными кавычками, встроенный код, URL-адреса, теги HTML и JSX возвращаются как есть, байт в байт.

Переводит ли он компоненты MDX?

Проза и однострочные части вокруг нее — да. Текст внутри многострочного JSX-компонента сохраняется, а не переводится, что является ограничением ридера формата.

Это бесплатно?

Да, без учетной записи: 10 000 символов на файл и до 8 языков за запуск. Бесплатный API-ключ увеличивает лимит файлов до 50 000 символов. Пожизненная лицензия стоит $79 один раз, при использовании вашего собственного ключа OpenRouter; ежемесячные планы начинаются от $19. Цены

Могу ли я запускать его из терминала или в CI?

Да. pip install kaeris, затем kaeris translate docs/guide.md --langs de,ja. GitHub Action выполняет ту же трансляцию в pull request. Документация CLI · GitHub Action

Продолжайте

Справочник по CLI · Справочник по проверке · Перевести в браузере · Бесплатная проверка · Конвертировать форматы · Псевдолокализация

Другие форматы: JSON · YAML · .po · ARB · XLIFF · .strings · .xcstrings · .properties · .resx · CSV · Fluent · Android XML