Markdown lässt sich leicht übersetzen, bis du zweihundert Seiten davon hast. Dann stimmen die Wörter, aber alles andere macht Probleme: Code, der sich nicht ändern darf, Links, die weiterhin funktionieren müssen, und das nächste Release, das zehn weitere Seiten hinzufügt.
Dieser Leitfaden richtet sich an Doku-Websites, READMEs, Changelogs und Blog-Ordner, die in Markdown oder MDX geschrieben sind.
Welche Option solltest du wählen?
| Geeignet für | Grenzen | |
|---|---|---|
| AI Glot | Einen Doku-Ordner, mehrere Sprachen, ein verbindliches Glossar und jedes Release | Für einen kurzen README-Absatz nicht nötig |
| Eine Übersetzungsmanagement-Plattform (Crowdin, Lokalise, Phrase) | Ein Team mit kontinuierlichem Workflow, Reviewern und Repository-Anbindung | Vor der ersten Übersetzung musst du ein Projekt einrichten und dein Repository verbinden |
| DeepL | Die dort aufgeführten Dokumente: Word, PowerPoint, Excel, PDF, HTML, Text und weitere | Markdown steht nicht auf der Liste. Du musst den Text also einfügen oder die Datei zuerst konvertieren |
| ChatGPT, Claude oder ein anderer Assistent | Eine kurze Seite | Du fügst jede Seite einzeln ein und musst dein Glossar in jeden Chat übernehmen. Prüfe jede Seite auf Änderungen an Code oder Links. Bei einem großen Doku-Ordner ist dein Nutzungslimit schnell erreicht |
| Ein Freelancer oder eine Agentur | Die Landingpage und die Preisseite | Langsam, Abrechnung pro Wort, und die Dateien musst du trotzdem vorbereiten |
Lass die Seite, auf der du dein Produkt verkaufst, von einer Person lesen. Lass die Referenzdokumentation von einer Engine übersetzen, denn dort fällt das meiste Volumen an.
Warum AI Glot für einen Doku-Ordner geeignet ist
- Inhalte rein, Struktur bleibt unangetastet. Überschriften, Absätze, Listenelemente und Tabellenzellen sind Text. Code, Linkziele, HTML-Blöcke und Tabellen-Trennzeichen bleiben unverändert.
- Hervorhebungen bleiben bei den zugehörigen Wörtern. Fett- und Kursivformatierung sowie Linktexte werden zusammen mit den Wörtern übertragen, zu denen sie gehören.
- Ein Glossar für die gesamte Doku-Website. Produktnamen und API-Begriffe sind auf jeder Seite und auch im nächsten Release einheitlich.
- Ein Plan, bevor Kosten entstehen. Er listet auf, was gefunden wurde und was übersetzt wird.
- Ein Auftrag für den ganzen Ordner. Pack die Dateien in ein ZIP, und die Ordnerstruktur wird wiederhergestellt.
Der Weg einer einzelnen Datei
- 1HochladenEine .md- oder .mdx-Datei oder ein ZIPBis zu 4 MB pro Datei
- 2Sagen Sie, was Sie brauchenEin einfacher SatzKostenlos
- 3Plan lesenErgebnisse, Sprachen, KostenKostenlos
- 4GenehmigenDer einzige kostenpflichtige SchrittVerbraucht Credits
- 5DownloadÜbersetztes MarkdownEinfach einfügen
Was sich in einer Seite ändert
Nur der Fließtext ändert sich. Der Code, der Link und die Schlüssel im Front Matter bleiben unverändert.
---title: Install the CLItitle: Installer la CLIslug: install---Run `npm install -g tool` and read the [guide](/de/docs/setup).Lancez `npm install -g tool` et lisez le [guide](/de/docs/setup).Was du bei MDX überprüfen solltest
Imports, Komponenten-Tags und Ausdrücke bleiben unverändert. So lässt sich die Seite weiterhin erstellen. Achte auf Text, den du einer Komponente als Prop übergibst, zum Beispiel einen Titel für eine Karte. Er gehört zur Komponente, nicht zum Fließtext. Überprüfe diese wenigen Zeichenfolgen anschließend.
Überschriftenanker. Wenn deine Website einen Anker aus dem Überschriftentext erstellt, erhält eine übersetzte Überschrift einen neuen Anker. Links, die auf eine Überschrift verweisen, zum Beispiel auf den Abschnitt „Installation“, solltest du überprüfen.
So geht’s Schritt für Schritt
1. Teste eine Datei kostenlos. Der Markdown-Übersetzer funktioniert ohne Konto und verarbeitet Dateien mit bis zu 2 MB und 5,000 Wörtern.
2. Lade die Datei oder ein ZIP-Archiv des Ordners in der App hoch.
3. Sag in einem Satz, was du brauchst.
Translate this folder into French.
Translate the prose and the front matter title and description.
Leave every other front matter field as it is.Der Satz legt fest, was im gesamten Ordner übersetzt wird. Eine Vorgabe zur Wortwahl, etwa „Produktnamen und API-Begriffe auf Englisch belassen“, gehört bei der Freigabe in das zweite Feld, da sie beim Schreiben auf jeden Absatz angewendet wird.
4. Füge ein Glossar hinzu mit Produktnamen, API-Begriffen und Wörtern, für die du immer dieselbe Formulierung verwendest. So erstellst du ein Glossar.
5. Lies den Plan und wähle eine Qualitätsstufe.
Lite liefert etwa dreimal mehr Wörter pro Guthaben und ist schneller. Damit eignet es sich für eine umfassende Aktualisierung der Referenzdokumentation. Standard ist für die Landingpage gedacht. Ein Guthaben entspricht in Standard einem Wort.
6. Gib die Übersetzung frei und lade sie herunter.
Ein Dokumentationsordner, mehrere Sprachen
Die Zahlen dienen als Beispiel. Eine Markdown-Datei enthält eine Sprache. Deshalb gibt es für jede Sprache eine eigene übersetzte Kopie des Ordners.
Drei Möglichkeiten, es auszuführen
Über die Befehlszeile eignet sich für ein Doku-Repository, denn dieselben vier Schritte lassen sich in einem Skript oder in CI ausführen, sobald sich das Englische ändert:
id=$(aiglot batches create docs.zip \
--instruction "Translate into French. Translate the prose and the front matter title and description." \
--json | jq -r '.data.id')
aiglot batches get "$id" --json | jq '.data.plan'
aiglot batches approve "$id" --quality lite \
--instructions "Keep product names and API terms in English."
aiglot batches download "$id" --output docs_fr.zipMit deinem KI-Agenten: Verbinde AI Glot als MCP-Server. Der Agent kann dein Repository lesen, gefundene Glossarbegriffe vorschlagen, den Auftrag ausführen und die Dateien wieder an ihren Platz legen.
In der App: hochladen, klicken, herunterladen. Gut geeignet für eine einzelne Seite.
Eine API-Integration wird in der API-Dokumentation beschrieben.
Ergebnis prüfen
Erstelle die Doku-Website in einer übersetzten Sprache und öffne drei Seiten: eine mit Code, eine mit einer Tabelle und eine mit einem Link zu einer anderen Seite. Lass deinen üblichen Link-Checker laufen, denn dort fällt eine Änderung an einem Anker auf. Behalte die englischen Dateien, bis jemand, der die Sprache spricht, die wichtigen Seiten geprüft hat.
Unter Preise siehst du, was ein größeres Volumen kostet. Mit einem kostenlosen Konto erhältst du Guthaben, um einen echten Ordner zu verarbeiten.
Die hier genannten Limits galten zum Zeitpunkt der Erstellung: 4 MB pro Markdown-Datei, 200 Dateien und 20 MB pro ZIP sowie 2 MB und 5,000 Wörter im kostenlosen Tool. Die Liste von DeepL stammt aus der eigenen Dokumentation. Dateinamen und Seitenzahlen in den Abbildungen sind Beispiele. In deinem Tarif siehst du die tatsächlichen Werte für deine Dateien. Das Nachlesen ist kostenlos.