Zum Inhalt springen
Zum Blog Dokumente

Markdown-Dateien übersetzen – Dokumentation und Wikis mehrsprachig machen

Markdown ist der Standard für alle, die Text mit wenigen Zeichen auszeichnen wollen: # für Überschriften, * für Listen, eckige Klammern für Links. Man findet es in Dokumentationen, Wikis, Readme-Dateien und zunehmend in Redaktionssystemen. Wer solche Texte in mehreren Sprachen anbieten möchte, kann sie als Datei übersetzen und muss sie nicht erst in ein anderes Format bringen.

Typische Anwendungsfälle

  • Unternehmen und Softwareteams: Produktdokumentation, Anleitungen, Changelogs, Readme-Dateien, Wissensdatenbanken.
  • Kommunen und Behörden: Texte für Open-Data-Portale, Bürgerinformationen in Redaktionssystemen oder statischen Websites, die Markdown nutzen.
  • Redaktionen, Bildung, Vereine: Texte für Blogs, Wikis und Lernplattformen, die in Markdown geschrieben werden.

Worauf Sie achten sollten

  • Struktur prüfen. Überschriften, Listen, Tabellen und Zitate sollen nach der Übersetzung dieselbe Gliederung haben. Vergleichen Sie Original und Übersetzung kurz nebeneinander.
  • Codeblöcke und Befehle. Quelltext in Codeblöcken soll nicht übersetzt werden. Prüfen Sie, dass Befehle, Dateinamen und Variablen unverändert geblieben sind. Kommentare im Code sind Geschmackssache.
  • Links und Anker. Linkziele wie #abschnitt hängen oft an der Überschrift. Wird die Überschrift übersetzt, passt der Anker nicht mehr. Kontrollieren Sie interne Verweise.
  • Front Matter. Viele Generatoren für statische Websites erwarten am Dateianfang einen Block mit Metadaten wie Titel, Datum und Schlagwörtern. Welche Felder übersetzt werden sollen und welche nicht, ist Ihre Entscheidung: Spracheinstellung und Dateipfade sollten unverändert bleiben.
  • Dateinamen und Ordner. Eine mehrsprachige Dokumentation braucht eine Ordnerstruktur, etwa de/ und en/. Das müssen Sie selbst organisieren.
  • Eingebettetes HTML. Es kann in Markdown vorkommen und braucht eine eigene Kontrolle.

Übersetzung als Ausgangspunkt

Eine maschinelle Übersetzung ist für technische Dokumentation eine gute Rohfassung. Fachbegriffe und Produktnamen sollten Sie trotzdem einmal durchsehen und notfalls in einem Glossar festhalten. Ändert sich die Quelle häufig, planen Sie ein, wie Sie Änderungen nachziehen: Eine neue Übersetzung ersetzt dann die alte Datei.

Markdown-Dateien mit dem Document Translator übersetzen

Der Document Translator von Conword soll Anfang 2027 starten, und für ihn ist die Unterstützung von Markdown-Dateien vorgesehen. Sie laden die Datei im Kundenportal hoch, wählen bis zu fünf Zielsprachen und bekommen die Übersetzungen im gleichen Format zurück. Übersetzt wird mit DeepL, die Verarbeitung findet in der EU statt.

Abgerechnet wird je Dokument und Sprache, nach Seiten gestaffelt: Eine Seite in einer Sprache entspricht 1.500 Zeichen, angefangene Seiten zählen voll. Die Seiten 1 bis 5 kosten zusammen 1,99 €, danach sinkt der Preis je Seite. Bezahlt wird mit Guthaben im Kundenportal; die ganze Staffel steht beim Document Translator. Weil die Übersetzung ein KI-Vorgang ist, sollten Sie Codeblöcke, Links und Metadaten stichprobenartig prüfen.

Eine Schnittstelle zum automatischen Übersetzen aus Ihrer Entwicklungsumgebung gibt es zum Start noch nicht, Dateien laden Sie im Kundenportal hoch. Wenn Sie wissen möchten, wann es losgeht, schreiben Sie uns.

Sprechen Sie mit uns

Noch Fragen?

Sagen Sie uns, was Sie vorhaben. Wir beraten Sie persönlich und finden gemeinsam die passende Lösung für Ihre Website.

Oder schreiben Sie uns

Wir verwenden Ihre Angaben, um Ihre Anfrage zu beantworten. Mehr dazu in den Datenschutzhinweisen.

Gehostet in der EU

Ihre Daten bleiben in Europa: Server, CDN, API und Kundenportal laufen ausschließlich in EU-Rechenzentren europäischer Anbieter.

Sprechen wir über Ihre Website

Übersetzen, vorlesen, verständlich machen: Sie haben dafür einen Ansprechpartner.

Schreiben Sie uns

Wir verwenden Ihre Angaben, um Ihre Anfrage zu beantworten. Mehr dazu in den Datenschutzhinweisen.

Website Translation: zur Produktseite
Accessibility Widget: zur Produktseite