Traduire les documents Markdown et MDX

Un document n'est pas une liste de clés. Son texte est dispersé dans des blocs de code, des liens et des front matter qui doivent revenir exactement. KAERIS divise le fichier en morceaux protégés et en prose, ne traduit que la prose et remet les morceaux en place.

KAERIS a traduit cette page et vérifié chaque ligne en la retraduisant. Un locuteur natif ne l'a pas encore revue. Original anglais

Traduire votre fichier Vérifier vos fichiers gratuitement

Comment un document Markdown est lu

Le document est découpé en un squelette de morceaux littéraux et en segments de texte numérotés. À l'intérieur d'un segment, le code en ligne, les cibles de liens, le HTML et les balises JSX sont échangés contre des jetons comme {0} avant la traduction et restaurés après. Un modèle qui en omet un déclenche le même détecteur qu'une variable omise.

Fichier sourcegetting-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.

Ce à quoi il faut faire attention dans les traductions Markdown

Le code n'est pas de la prose
Un bloc de code traduit continue de s'afficher, puis échoue pour le lecteur qui le copie. Les blocs de code délimités et indentés, le code en ligne et les lignes import/export de MDX ne sont jamais traduits.
Liens
Le texte du lien est traduit ; la cible du lien ne l'est pas. Une URL traduite ressemble toujours à un lien et renvoie ensuite une erreur 404.
Front matter
Les paramètres tels que slug, date, layout et tags reviennent inchangés. Les champs visibles par le lecteur, tels que title et summary, sont traduits.
Une limite connue
Le texte à l'intérieur d'un composant JSX multiligne est préservé en entier, non traduit. Le lecteur de cette page en est informé ici plutôt qu'après une compilation.

Une exécution réelle, avant et après

Une exécution réelle : notre document de test, allemand, 26 octobre 2026, réduit au début et à un bloc de code. Le titre, le texte en gras, la commande curl et le jeton $TOKEN sont tels qu'ils sont dans la source ; seuls la prose et les champs du front matter visibles par le lecteur ont changé.

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

Aprèsde/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"
```

Ce que KAERIS en fait

Squelette et prose maintenus séparés
Les titres, tableaux, listes et délimitations conservent leur forme ; seule la prose à l'intérieur est échangée.
Une sortie par langue
guide.md devient de.md, ja.md et ainsi de suite.
Chaque ligne retraduite
--verify retraduit le résultat et écrit verify.json afin que vous puissiez lire ce que chaque partie dit maintenant.

Traduire votre fichier Vérifier vos fichiers gratuitement

Exécutez-le en trois étapes

Installer le CLI
Exécutez pip install kaeris.
Traduire le document
Exécutez kaeris translate docs/guide.md --langs de,ja. Un glob tel que docs/*.md traduit plusieurs fichiers.
Lire le résultat
Ouvrez verify.json issu de l'exécution --verify pour voir ce que chaque partie traduite dit maintenant dans votre langue.

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

Questions

Le code est-il traduit dans mes documents ?

Non. Les blocs de code délimités et indentés, le code en ligne, les URL, les balises HTML et JSX sont restitués tels quels.

Traduit-il les composants MDX ?

La prose et les parties en ligne unique autour, oui. Le texte à l'intérieur d'un composant JSX multiligne est préservé plutôt que traduit, ce qui est une limite du lecteur de format.

Est-ce gratuit ?

Oui, sans compte : 10 000 caractères par fichier et jusqu'à 8 langues par exécution. Une clé API gratuite augmente la limite de fichiers à 50 000 caractères. La licence à vie est de 79 $ une fois, sur votre propre clé OpenRouter ; les plans mensuels commencent à 19 $. Tarifs

Puis-je l'exécuter depuis le terminal ou en CI ?

Oui. pip install kaeris, puis kaeris translate docs/guide.md --langs de,ja. Le GitHub Action exécute la même traduction dans une pull request. Docs CLI · GitHub Action

Continuer

Référence CLI · Référence Check · Traduire dans le navigateur · Vérification gratuite · Convertir les formats · Localisation fictive

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