Markdown übersetzen
Dieses Werkzeug übersetzt den Fließtext einer Markdown-Datei – etwa eine README, eine Dokumentationsseite oder einen Blogbeitrag – in eine andere Sprache und lässt Überschriften-Syntax, Links, Codeblöcke und Listenstruktur unverändert. Gedacht für technische Dokumentation und Inhalte, die anschließend wieder als Markdown weiterverarbeitet werden.
Online ausführen
Führen Sie dies mit Ihrem Konto auf unseren Servern aus. Kostenlose Tools laufen in Ihrem Browser; dieses wird zum oben genannten Preis von Ihrem KIT-Guthaben abgebucht.
Was unverändert bleibt
Codeblöcke, Inline-Code, Links samt Ziel-URL, Bildpfade sowie die Markdown-Syntax für Überschriften, Listen, Tabellen und Zitate bleiben unverändert erhalten. Übersetzt wird ausschließlich der lesbare Fließtext dazwischen: Überschriftentexte, Absätze, Linktexte und die Zellinhalte einer Tabelle. Ein Codebeispiel innerhalb der Datei bleibt bewusst in seiner Ausgangssprache stehen, da Quellcode grundsätzlich nicht übersetzt werden soll, selbst wenn Kommentare darin enthalten sind. Für die gezielte Übersetzung solcher Kommentare gibt es ein eigenes Werkzeug.
Für README und Dokumentation
Eine README-Datei eines Softwareprojekts, eine mehrseitige technische Dokumentation oder ein Blogbeitrag im Markdown-Format lässt sich so in eine zweite Sprache bringen, ohne die Gliederung, die Verlinkung oder die Formatierung von Hand nachzubauen. Das Ergebnis lässt sich unmittelbar wieder ins Repository, ins Dokumentationssystem oder ins Content-Management-System einspielen, mit derselben Struktur wie die Ausgangsdatei, Zeile für Zeile vergleichbar und ohne zusätzlichen Formatierungsaufwand.
Preis
$0.003 pro Anfrage plus $0.0135 je 1.000 Wörter des reinen Fließtextes; Codeblöcke und Inline-Code zählen dabei nicht mit, da sie unverändert bleiben. Eine README mit rund 800 Wörtern Beschreibungstext kostet damit deutlich unter einem US-Dollar, eine umfangreiche Dokumentationsseite mit mehreren Tausend Wörtern entsprechend mehr. Der genaue Betrag wird vor dem Absenden angezeigt, ohne Abonnement, ohne Grundgebühr und ohne versteckte Kosten für Formatierung oder Struktur.
Nutzung
Genutzt wird die Übersetzung direkt auf dieser Seite, durch Einfügen oder Hochladen der Datei, oder über die API innerhalb einer bestehenden Dokumentations- oder Build-Pipeline, etwa um bei jedem Release automatisch eine zweite Sprachversion zu erzeugen. Es handelt sich um ein Werkzeug mit mehreren Zugangswegen, nicht um „eine API“. Für HTML-Seiten oder reine CSV-Tabellen nutzen Sie besser die jeweiligen Schwesterwerkzeuge, statt Markdown-Quelltext einzufügen.
Anwendungsfälle
Die README für internationale Beitragende
Ein Open-Source-Projekt von Jonas Weber übersetzt die README-Datei ins Englische, damit auch internationale Beitragende die Installationsschritte und die Beitragsrichtlinien ohne Umweg verstehen.
Die interne Dokumentation für ein verteiltes Team
Schneider IT-Systeme GmbH & Co. KG übersetzt technische Dokumentation aus dem internen Wiki ins Englische, für Entwickler an einem zweiten Standort außerhalb Deutschlands.
Der Blogbeitrag als Markdown-Export
Anna Hoffmann exportiert einen Blogbeitrag aus ihrem Content-Management-System als Markdown-Datei, lässt ihn übersetzen und spielt die englische Fassung anschließend wieder ein.
Häufige Fragen
Bleiben Codebeispiele in der Ausgangssprache stehen?
Ja, Codeblöcke und Inline-Code werden nicht übersetzt, nur Kommentare außerhalb des Codes, sofern sie als Fließtext vorliegen.
Was zählt für den Preis: die ganze Datei oder nur der Text?
Nur der reine Fließtext außerhalb von Codeblöcken; $0.003 pro Anfrage plus $0.0135 je 1.000 Wörter dieses Textes.
Bleiben interne Verlinkungen zwischen Dokumentationsseiten erhalten?
Ja, Linkziele werden nicht verändert, auch wenn der sichtbare Linktext übersetzt wird.
Wird die hochgeladene Datei gespeichert?
Nein, sie wird zur Übersetzung verarbeitet und danach nicht aufbewahrt; ein Konto ist nicht erforderlich.
Wie umfangreich darf die Datei sein?
Rund 20.000 Token Fließtext pro Anfrage; für eine mehrteilige Dokumentation lässt sich jede Seite einzeln übersetzen.
Funktioniert das auch mit GitHub-Flavored Markdown?
Ja, Tabellen, Aufgabenlisten und Fußnoten im GitHub-üblichen Markdown-Dialekt werden erkannt und in ihrer Syntax beibehalten.
Für Entwickler — API-Zugang
Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.
Endpunkt
Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.
Aufruf aus Ihrem Stack
curl -X POST https://api.kit.forhosting.com/translate/markdown \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"…"}'const res = await fetch("https://api.kit.forhosting.com/translate/markdown", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"text": "…"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/translate/markdown",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"text": "…"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/translate/markdown", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"text":"…"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"text":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/translate/markdown", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Beispiel-Anfrage
{
"text": "…"
}Beispiel-Antwort
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "translate.markdown",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.
Preis
Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.
Limits
max_tokens | 20000 |
Fehler
| HTTP | Code | Bedeutung |
|---|---|---|
401 | unauthorized | Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer). |
402 | insufficient_balance | Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht. |
404 | unknown_type | Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog. |
429 | rate_limited | Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt. |
422 | task_failed | Die Aufgabe ist fehlgeschlagen und wird nicht berechnet. |