Docsbook
Übersicht

SEO für mehrsprachige Dokumentationen: hreflang und URLs

Die meisten Produktdokumentationen sind 2026 nur auf Englisch verfügbar. Teams, die ihre Inhalte professionell übersetzen, gewinnen organischen Traffic, den rein englischsprachige Websites nie erreichen – Suchanfragen auf Japanisch, Spanisch, Deutsch und Mandarin mit derselben Kaufabsicht.

Dieser Beitrag ist der praktische SEO-Leitfaden für die Veröffentlichung von Dokumentationen in 15 Sprachen, ohne Google oder die KI-Suche zu beeinträchtigen.

Kurzfassung#

  • Jede Sprache muss unter einer separaten URL (/ja/, /es/, /de/) verfügbar sein
  • Füge hreflang-Tags hinzu, damit Suchmaschinen wissen, welche Version eine Übersetzung welcher anderen ist
  • Verwende das Attribut lang für das Element <html>
  • KI-Übersetzungen sind 2026 gut genug für Dokumentationen (nicht für Marketingtexte)
  • Eine kanonische englische Quelle, darauf aufbauend KI-Übersetzungen – niemals doppelte Quellen

Die grundlegende Regel#

Eine URL pro (Seite, Sprache)-Kombination.

Falsch:

docs.yourcompany.com/quick-start?lang=ja
docs.yourcompany.com/quick-start (with cookies)

Richtig:

docs.yourcompany.com/quick-start
docs.yourcompany.com/ja/quick-start
docs.yourcompany.com/es/quick-start

Ohne separate URLs gibt es für eine Suchmaschine nichts, was sie pro Sprache indexieren kann: Eine URL enthält ein Dokument in ihrem Index, daher kann nur die Sprache, die sie gesehen hat, ein Ranking erzielen. Jede andere Sprachversion bleibt für die Suche in ihrer eigenen Sprache unsichtbar, ganz gleich, wie gut die Übersetzung ist.

hreflang-Einrichtung#

Jede Seite benötigt <link rel="alternate" hreflang="...">-Tags, die auf jede Übersetzung verweisen.

<link rel="alternate" hreflang="en" href="https://docs.yourcompany.com/quick-start">
<link rel="alternate" hreflang="ja" href="https://docs.yourcompany.com/ja/quick-start">
<link rel="alternate" hreflang="es" href="https://docs.yourcompany.com/es/quick-start">
<link rel="alternate" hreflang="x-default" href="https://docs.yourcompany.com/quick-start">

x-default teilt Google mit: „Wenn keine andere Region passt, zeige diese Version an.“ Normalerweise ist das die englische Version.

Docsbook generiert hreflang automatisch, wenn du unter Einstellungen → Sprachen eine Sprache aktivierst.

Wann KI-Übersetzung gut genug ist#

Drei Faktoren:

Inhaltstyp Qualität der KI-Übersetzung Empfehlung
Referenzdokumentation (API, Konfiguration) Hoch KI verwenden
Tutorials und Anleitungen Hoch KI verwenden, kurze menschliche Prüfung
Marketing-Landingpages Mittel Menschliche Prüfung erforderlich
Markentexte (Slogans, Mission) Niedrig Menschliche Übersetzung
Codebeispiele N/A Original beibehalten
Fehlermeldungen Hoch bei konsistenter Terminologie KI verwenden

Die Qualität der LLM-Übersetzung für technische Inhalte hat sich zwischen 2023 und 2026 stark verbessert. Speziell für Dokumentation bietet maschinelle Übersetzung strukturelle Vorteile gegenüber einem menschlichen Prozess und nicht nur einen Preisvorteil:

  • Terminologische Konsistenz. Ein Modell verwendet auf tausend Seiten denselben Begriff für dasselbe Konzept; ein wechselnder Pool menschlicher Übersetzer weicht davon ab, und diese Abweichung bleibt unsichtbar, bis ein Leser einen Fehler deswegen meldet.
  • Geschwindigkeit. Fünfzehn Sprachen in wenigen Minuten statt eines Angebots- und Planungszyklus pro Sprache.
  • Überarbeitungskosten. Die tatsächlichen Kosten menschlicher Übersetzung entstehen nicht beim ersten Durchlauf, sondern bei jeder anschließenden Überarbeitung: Ändert man einen Absatz, zahlt man in jeder Sprache erneut pro Wort. Maschinelle Übersetzung berechnet die geänderte Seite neu. Deshalb veralten übersetzte Dokumente in einer menschlichen Pipeline, während sie in einer maschinellen Pipeline aktuell bleiben.

Worin Menschen weiterhin besser sind:

  • Kulturelle Lokalisierung (Datumsformate, Beispiele, Markenstimme)
  • Rechtlich besonders kritische Texte
  • Marketing-Slogans

Bei Dokumentation spricht das Kosten-Nutzen-Verhältnis 2026 deutlich für KI-Übersetzung.

Jede Sprache wird separat indexiert#

Drei Signale sind wichtig:

  1. URL-Muster — /ja/ Unterverzeichnis oder ja.yourdomain.com Subdomain (Unterverzeichnis ist einfacher)
  2. hreflang-Tags — bidirektional, in beide Richtungen zwischen allen Versionen verweisen
  3. lang-Attribut — <html lang="ja"> in der japanischen Version
  4. Sitemap-Einträge — jede Sprache erhält einen eigenen Eintrag mit xhtml:link-Annotationen

Google bewertet dann jede Sprache in den Suchergebnissen der jeweiligen Region. Ein Nutzer in Japan, der auf Japanisch sucht, sieht /ja/. Ein Nutzer in Spanien, der auf Spanisch sucht, sieht /es/.

Was KI-Suchmaschinen mit Übersetzungen machen#

Drei beobachtete Verhaltensweisen:

ChatGPT#

ChatGPT wird eine übersetzte Seite zitieren, wenn die Anfrage in dieser Sprache gestellt ist. Die Frage an ChatGPT „ドキュメンテーションプラットフォームを比較してください“ (Dokumentationsplattformen auf Japanisch vergleichen) liefert japanische Quellen, einschließlich japanischer Versionen der Dokumentation.

Perplexität#

Wie ChatGPT – Perplexity stimmt die Abfragesprache strikt mit der Quellsprache ab. Wenn Sie gut übersetzen, gewinnen Sie einen Zitierkanal pro Sprache.

Gemini#

Google Gemini verwendet den zugrunde liegenden Index von Google. Dieselben hreflang- und Gebietsschemasignale, die Google AI Overviews unterstützen, helfen auch Gemini.

Wie Docsbook mehrsprachig ausgeliefert wird#

Drei Schritte zum Aktivieren einer Sprache:

  1. Dashboard → Einstellungen → Sprachen → Sprache auswählen → aktivieren
  2. Die KI übersetzt den gesamten Dokumentationssatz in diese Sprache; der Übersetzungslauf wird in Dollar gegen das Guthaben des Projekts abgerechnet
  3. Die Seite erscheint unter /{language-code}/{path} mit korrekt gesetztem hreflang und lang

15 Sprachen werden unterstützt: EN, ES, FR, DE, PT, IT, RU, ZH, JA, KO, AR, HI, TR, PL, NL.

Sie können Ihre eigenen Übersetzungen auch über das MCP-Tool upload_translation oder die Admin-Oberfläche hochladen, wenn Sie einen menschlichen Übersetzer haben.

Übersetzungsmodi#

Drei Modi verfügbar:

  • Automatisch — Docsbook AI übersetzt alles automatisch
  • Manuell — Warteschlange für ausstehende Übersetzungen, Sie prüfen vor der Veröffentlichung
  • Extern — Webhook für Ihre eigene Übersetzungspipeline (Ihr TMS, Ihre Übersetzer)

Der externe Modus ist für Teams gedacht, die bereits über einen Übersetzungsspeicher verfügen und ihn weiterhin verwenden möchten. Das set_translation_mode-MCP-Tool wechselt zwischen den Modi.

Fehler, die mehrsprachige SEO zunichtemachen#

  • Umschalten über Abfrageparameter (?lang=ja) — Google indexiert diese nicht als separate Seiten
  • Spracherkennung auf Cookie-Basis — dasselbe Problem, nur eine URL wird indexiert
  • Fehlende hreflang-Tags — Google behandelt Übersetzungen als doppelte Inhalte
  • Einseitiges hreflang — beide Seiten müssen aufeinander verweisen
  • Kein lang-Attribut — Screenreader und Crawler greifen auf Englisch zurück

Kostenökonomie#

Übersetzung von 200 Seiten in 14 zusätzliche Sprachen:

Manuelle Übersetzung durch Menschen Docsbook-KI-Übersetzung
Kosten Pro Wort, pro Sprache kalkuliert und bei jeder Überarbeitung erneut bezahlt Nach jeder Übersetzung anhand des Projektguthabens abgerechnet
Zeit Monate Stunden
Aktualisierungskosten Bei jeder Änderung der Quellseite erneut pro Wort berechnet Bei Änderungen der Quelle neu berechnet
SEO-Indexierung Manuelle hreflang-Einrichtung Automatisch pro Region
Am besten geeignet für Rechtliche, regulierte und Marketingtexte, die von einem Menschen freigegeben werden müssen Referenz- und Anleitungsinhalte, die häufig geändert werden

Maschinelle Übersetzung ist nicht uneingeschränkt besser. Sie ist besser bei der Aufgabe, an der die meisten Übersetzungsprojekte scheitern: nicht an der ersten Übersetzung, sondern an der zwanzigsten Überarbeitung.

Kostenlos starten — keine Kreditkarte erforderlich

Nächste Schritte#

Updated

War diese Seite hilfreich?

Powered by Docsbook