Traduzir

Traduz documentos Markdown e MDX

Um documento não é uma lista de chaves. Seu texto está espalhado por blocos de código, links e front matter que devem retornar exatamente. KAERIS divide o arquivo em pedaços protegidos e prosa, traduz apenas a prosa e junta os pedaços de volta.

KAERIS traduziu esta página e verificou cada linha traduzindo-a de volta. Um falante nativo ainda não revisou. Original em inglês

Como um documento Markdown é lido

O documento é cortado em um esqueleto de pedaços literais e segmentos de texto numerados. Dentro de um segmento, código inline, alvos de link, tags HTML e JSX são trocados por tokens como {0} antes da tradução e restaurados depois. Um modelo que perde um aciona o mesmo detector que uma variável perdida.

Arquivo de origemgetting-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.

O que observar em traduções Markdown

Uma execução real, antes e depois

Uma execução real: nosso documento de teste, alemão, 26 de outubro de 2026, cortado para o início e um bloco de código. O título, texto em negrito, o comando curl e o token $TOKEN estão como na origem; apenas a prosa e os campos de front-matter que um leitor vê mudaram.

Anteshelp-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"
```
Depoisde/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"
```

O que o KAERIS faz com isso

Execute em três etapas

  1. Instale o CLI

    Execute pip install kaeris.

  2. Traduza o documento

    Execute kaeris translate docs/guide.md --langs de,ja. Um glob como docs/*.md traduz vários arquivos.

  3. Leia de volta

    Abra verify.json da execução --verify para ver o que cada parte traduzida diz agora em seu idioma.

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

Perguntas

O código na minha documentação é traduzido?

Não. Blocos de código delimitados e indentados, código inline, URLs, tags HTML e JSX retornam byte a byte.

Ele traduz componentes MDX?

O texto e as partes de linha única ao redor deles, sim. O texto dentro de um componente JSX de várias linhas é preservado em vez de traduzido, o que é uma limitação do leitor de formato.

É gratuito?

Sim, sem conta: 10.000 caracteres por arquivo e até 8 idiomas por execução. Uma chave API gratuita eleva o limite para 50.000 caracteres. A licença vitalícia custa $79 uma vez, usando sua própria chave OpenRouter; planos mensais começam em $19. Preços

Posso rodar pelo terminal ou em CI?

Sim. pip install kaeris, depois kaeris translate docs/guide.md --langs de,ja. O GitHub Action executa a mesma tradução em um pull request. Docs da CLI · GitHub Action

Continue

Referência do CLI · Referência de verificação · Traduzir no navegador · Verificação gratuita · Converter formatos · Pseudo-localização

Outros formatos: JSON · YAML · .po · ARB · XLIFF · .strings · .xcstrings · .properties · .resx · CSV · Fluent · Android XML