Bleibt die Dokumentstruktur bei der Übersetzung erhalten?

Ja. Überschriften, Listen, Links, Hervorhebungen und Code-Ausschnitte bleiben bei der Übersetzung erhalten und werden im Export übernommen, sodass sich die übersetzte Datei nahtlos in dieselbe Pipeline wie die Quelldatei einfügt.

Muss ich erneut bezahlen, wenn ich ein unverändertes Dokument noch einmal durchlaufen lasse?

Nein. Bei der Einstellung „nur Aktualisierungen“ (only-updated) verarbeitet ein Durchlauf nur die Blöcke, deren Quelltext sich seit dem letzten Durchlauf geändert hat. Ein unverändertes Dokument erneut durchlaufen zu lassen, kostet nichts, und eine kleine Änderung kostet lediglich eine Handvoll Blöcke.

Ein Markdown-Dokument über die API lokalisieren

Gepflegt von Vitalii VlasiukCo-founderVeröffentlicht Juni 2026Aktualisiert am 5. August 2026

Markdown ist das Format, in dem die meisten Dokumente, Hilfeartikel und CMS-Inhalte bereits vorliegen. Senden Sie es einfach unverändert an die API, führen Sie einen Workflow für Ihre Sprachen aus und rufen Sie dasselbe Markdown pro Sprache wieder ab – die Struktur bleibt dabei vollständig erhalten.

Auf dieser Seite

Wie sende ich Markdown-Inhalte ein?

Senden Sie POST /documents mit content_type: "markdown" und Ihren Zielsprachen. Transept unterteilt das Dokument in Blöcke und erstellt pro Zielsprache eine Sprachversion.

Führen Sie anschließend die Schätzung und den Durchlauf durch, wie unter Transept mit der API automatisieren beschrieben; der Durchlauf deckt mit einem einzigen Aufruf alle Sprachversionen ab.

# BASE="https://app.transept.ai/api/public/v1"; KEY from Settings → Developer
curl -s -X POST $BASE/documents \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"title": "Getting started", "content_type": "markdown", "source_language": "en",
       "target_languages": ["de", "fr"],
       "content": "# Getting started\n\nInstall the app, then…"}'
# → { document_id, language_group: [ {id, target_language}, … ] }

Wie rufe ich die Übersetzungen ab?

GET /documents/{id}/content?format=markdown für die jeweilige Sprachversion liefert das gerenderte Markdown mit erhaltener Struktur zurück. Die weiteren Formate (json für blockweises Auslesen, docx, pdf, xliff, csv) sind in der Format-Tabelle unter Transept mit der API automatisieren aufgeführt.

curl -s "$BASE/documents/<de-version-id>/content?format=markdown" \
  -H "Authorization: Bearer $KEY"

Wie übersetze ich nur die Änderungen neu?

Wenn sich die Quelle später ändert, führen Sie einen Abgleich durch, anstatt das Dokument neu zu importieren: POST /documents/{id}/resync-source behält unveränderte Blöcke (und deren Übersetzungen) bei und markiert geänderte oder hinzugefügte Blöcke als veraltet, und ein Durchlauf mit dem Verhalten „only-updated“ verarbeitet dann nur diese. Es ist das Pendant für Fließtext zu den schlüsselbasierten Deltas in Einen String-Katalog über die API lokalisieren; das allgemeine Prinzip wird unter Nur geänderte Inhalte verarbeiten beschrieben.

# the source changed? re-align, then run only what went stale
curl -s -X POST $BASE/documents/<master>/resync-source \
  -H "Authorization: Bearer $KEY"

Häufige Fragen✦

Bleibt die Dokumentstruktur bei der Übersetzung erhalten?: Ja. Überschriften, Listen, Links, Hervorhebungen und Code-Ausschnitte bleiben bei der Übersetzung erhalten und werden im Export übernommen, sodass sich die übersetzte Datei nahtlos in dieselbe Pipeline wie die Quelldatei einfügt.
Muss ich erneut bezahlen, wenn ich ein unverändertes Dokument noch einmal durchlaufen lasse?: Nein. Bei der Einstellung „nur Aktualisierungen“ (only-updated) verarbeitet ein Durchlauf nur die Blöcke, deren Quelltext sich seit dem letzten Durchlauf geändert hat. Ein unverändertes Dokument erneut durchlaufen zu lassen, kostet nichts, und eine kleine Änderung kostet lediglich eine Handvoll Blöcke.

Weiterlesen✦

Funktionen entdecken✦

Kommen Sie nicht weiter? Fragen Sie Literess in der App oder schreiben Sie an [email protected].