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.
--- 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
Código não é prosa
Um bloco de código traduzido ainda renderiza, e então falha para o leitor que o copia. Blocos de código cercados e indentados, código inline e linhas
import/exportdo MDX nunca são traduzidos.Links
O texto do link é traduzido; o alvo do link não é. Um URL traduzido ainda parece um link e então retorna 404.
Front matter
Configurações como
slug,date,layoutetagsretornam inalteradas. Campos que um leitor vê, comotitleesummary, são traduzidos.Um limite conhecido
Texto dentro de um componente JSX multilinha é preservado inteiro, não traduzido. O leitor desta página é informado aqui em vez de após um build.
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.
---
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"
```
---
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
Esqueleto e prosa mantidos separados
Títulos, tabelas, listas e cercas mantêm sua forma; apenas a prosa interna é trocada.
Uma saída por idioma
guide.mdse tornade.md,ja.mde assim por diante.Cada linha traduzida de volta
--verifytraduz o resultado de volta e escreveverify.jsonpara que você possa ler o que cada parte diz agora.
Execute em três etapas
Instale o CLI
Execute
pip install kaeris.Traduza o documento
Execute
kaeris translate docs/guide.md --langs de,ja. Um glob comodocs/*.mdtraduz vários arquivos.Leia de volta
Abra
verify.jsonda execução--verifypara 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