Traduci documenti Markdown e MDX

Un documento non è un elenco di chiavi. Il suo testo è sparso tra blocchi di codice, link e front matter che devono tornare esattamente. KAERIS divide il file in pezzi protetti e prosa, traduce solo la prosa e rimette insieme i pezzi.

KAERIS ha tradotto questa pagina e controllato ogni riga ritraducendola. Un madrelingua non l'ha ancora revisionata. Originale in inglese

Traduci il tuo file Controlla i tuoi file gratuitamente

Come viene letto un documento Markdown

Il documento viene tagliato in uno scheletro di pezzi letterali e segmenti di testo numerati. All'interno di un segmento, codice inline, target di link, tag HTML e JSX vengono scambiati con token come {0} prima della traduzione e ripristinati dopo. Un modello che ne perde uno fa scattare lo stesso rilevatore di una variabile persa.

File sorgentegetting-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.

Cosa osservare nelle traduzioni Markdown

Il codice non è prosa
Un blocco di codice tradotto viene ancora renderizzato e poi fallisce per il lettore che lo copia. Blocchi di codice recintati e indentati, codice inline e righe import/export di MDX non vengono mai tradotti.
Link
Il testo del link viene tradotto; il target del link no. Un URL tradotto appare ancora come un link e poi restituisce 404.
Front matter
Impostazioni come slug, date, layout e tags tornano invariate. I campi che un lettore vede, come title e summary, vengono tradotti.
Un limite noto
Il testo all'interno di un componente JSX multilinea viene preservato intero, non tradotto. Al lettore di questa pagina viene detto qui piuttosto che dopo una build.

Una vera esecuzione, prima e dopo

Una vera esecuzione: il nostro documento di test, tedesco, 26 ottobre 2026, ridotto all'inizio e a un blocco di codice. L'intestazione, il testo in grassetto, il comando curl e il token $TOKEN sono come nel sorgente; solo la prosa e i campi del front-matter che un lettore vede sono cambiati.

Primahelp-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"
```

Dopode/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"
```

Cosa fa KAERIS con esso

Scheletro e prosa tenuti separati
Intestazioni, tabelle, elenchi e recinzioni mantengono la loro forma; solo la prosa all'interno viene scambiata.
Un output per lingua
guide.md diventa de.md, ja.md e così via.
Ogni riga tradotta indietro
--verify traduce il risultato indietro e scrive verify.json in modo che tu possa leggere cosa dice ora ogni parte.

Traduci il tuo file Controlla i tuoi file gratuitamente

Eseguilo in tre passaggi

Installa la CLI
Esegui pip install kaeris.
Traduci il documento
Esegui kaeris translate docs/guide.md --langs de,ja. Un glob come docs/*.md traduce diversi file.
Rileggilo
Apri verify.json dall'esecuzione --verify per vedere cosa dice ora ogni parte tradotta nella tua lingua.

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

Domande

Il codice nei miei documenti viene tradotto?

No. Blocchi di codice racchiusi tra backtick e indentati, codice inline, URL, tag HTML e JSX vengono restituiti byte per byte.

Traduce i componenti MDX?

La prosa e le parti a riga singola attorno ad essi, sì. Il testo all'interno di un componente JSX multilinea viene preservato anziché tradotto, il che è un limite del lettore di formato.

È gratuito?

Sì, senza account: 10.000 caratteri per file e fino a 8 lingue per esecuzione. Una chiave API gratuita aumenta il limite di file a 50.000 caratteri. A vita costa $79 una tantum, sulla tua chiave OpenRouter; i piani mensili partono da $19. Prezzi

Posso eseguirlo dal terminale o in CI?

Sì. pip install kaeris, quindi kaeris translate docs/guide.md --langs de,ja. La GitHub Action esegue la stessa traduzione in una pull request. Documentazione CLI · GitHub Action

Continua

Riferimento CLI · Riferimento Check · Traduci nel browser · Controllo gratuito · Converti formati · Pseudo-localizzazione

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