Перекласти

Переклад документів Markdown та MDX

Документ — це не список ключів. Його текст розкиданий по блоках коду, посиланнях і front matter, які мають повернутися без змін. 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 як у джерелі; змінено лише прозу та поля front matter, які бачить читач.

До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