Markdown- und MDX-Dokumente übersetzen

Ein Dokument ist keine Liste von Schlüsseln. Sein Text ist über Codeblöcke, Links und Front Matter verstreut, die exakt zurückkommen müssen. KAERIS teilt die Datei in geschützte Teile und Prosa auf, übersetzt nur die Prosa und setzt die Teile wieder zusammen.

KAERIS hat diese Seite übersetzt und jede Zeile durch Rückübersetzung geprüft. Ein Muttersprachler hat sie noch nicht überprüft. Englisches Original

Übersetze deine Datei Überprüfe deine Dateien kostenlos

Wie ein Markdown-Dokument gelesen wird

Das Dokument wird in ein Gerüst aus literalen Teilen und nummerierten Textsegmenten zerlegt. Innerhalb eines Segments werden Inline-Code, Linkziele, HTML- und JSX-Tags durch Token wie {0} ersetzt und nach der Übersetzung wiederhergestellt. Ein Modell, das eines davon fallen lässt, löst denselben Detektor aus wie eine fehlende Variable.

Quelldateigetting-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.

Worauf Sie bei Markdown-Übersetzungen achten sollten

Code ist keine Prosa
Ein übersetzter Codeblock wird immer noch gerendert und schlägt dann für den Leser fehl, der ihn kopiert. Eingefasste und eingerückte Codeblöcke, Inline-Code und MDX import/export-Zeilen werden nie übersetzt.
Links
Der Linktext wird übersetzt; das Linkziel nicht. Eine übersetzte URL sieht immer noch wie ein Link aus und gibt dann 404 zurück.
Front Matter
Einstellungen wie slug, date, layout und tags bleiben unverändert. Felder, die ein Leser sieht, wie title und summary, werden übersetzt.
Eine bekannte Einschränkung
Text innerhalb einer mehrzeiligen JSX-Komponente wird als Ganzes beibehalten, nicht übersetzt. Der Leser dieser Seite wird hier darüber informiert, nicht nach einem Build.

Ein realer Durchlauf, vorher und nachher

Ein realer Durchlauf: unser Testdokument, Deutsch, 26. Oktober 2026, gekürzt auf den Anfang und einen Codeblock. Die Überschrift, der fette Text, der Curl-Befehl und das Token $TOKEN sind wie in der Quelle; nur die Prosa und die Front-Matter-Felder, die ein Leser sieht, wurden geändert.

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

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

Was KAERIS damit macht

Gerüst und Prosa getrennt gehalten
Überschriften, Tabellen, Listen und Zäune behalten ihre Form; nur die Prosa darin wird ausgetauscht.
Eine Ausgabe pro Sprache
guide.md wird zu de.md, ja.md und so weiter.
Jede Zeile zurückübersetzt
--verify übersetzt das Ergebnis zurück und schreibt verify.json, damit Sie lesen können, was jeder Teil jetzt sagt.

Übersetze deine Datei Überprüfe deine Dateien kostenlos

In drei Schritten ausführen

CLI installieren
Führen Sie pip install kaeris aus.
Übersetzen Sie das Dokument
Führen Sie kaeris translate docs/guide.md --langs de,ja aus. Ein Glob wie docs/*.md übersetzt mehrere Dateien.
Lesen Sie es zurück
Öffnen Sie verify.json aus dem --verify-Durchlauf, um zu sehen, was jeder übersetzte Teil jetzt in Ihrer Sprache sagt.

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

Fragen

Wird Code in meinen Dokumenten übersetzt?

Nein. Eingeschlossene und eingerückte Codeblöcke, Inline-Code, URLs, HTML- und JSX-Tags werden Byte für Byte zurückgegeben.

Übersetzt es MDX-Komponenten?

Prosa und die einzeiligen Teile darum herum, ja. Text innerhalb einer mehrzeiligen JSX-Komponente wird beibehalten und nicht übersetzt, was eine Einschränkung des Format-Readers darstellt.

Ist es kostenlos?

Ja, ohne Konto: 10.000 Zeichen pro Datei und bis zu 8 Sprachen pro Lauf. Ein kostenloser API-Schlüssel erhöht das Dateilimit auf 50.000 Zeichen. Lebenslang kostet es einmalig 79 $, mit deinem eigenen OpenRouter-Schlüssel; monatliche Pläne beginnen bei 19 $. Preise

Kann ich es vom Terminal oder in CI ausführen?

Ja. pip install kaeris, dann kaeris translate docs/guide.md --langs de,ja. Die GitHub Action führt die gleiche Übersetzung in einem Pull Request aus. CLI-Dokumentation · GitHub Action

Weiter geht's

CLI-Referenz · Check-Referenz · Im Browser übersetzen · Kostenlose Prüfung · Formate konvertieren · Pseudo-Lokalisierung

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