MDX-Dateien¶

Added in version 2026.5.

Bemerkung

Die Unterstützung für dieses Format befindet sich in der Entwicklung. Einige Funktionen sind möglicherweise noch nicht verfügbar, und das Verhalten kann sich zwischen den verschiedenen Versionen ändern. Rückmeldungen aus der Testphase sind willkommen.

MDX files are Markdown files with JSX syntax. Weblate extracts translatable Markdown text and preserves imports, exports, JSX components, and expressions.

MDX units automatically get the md-text and auto-safe-html flags. This keeps the unsafe HTML check active for plain text, standard HTML, and custom elements while avoiding HTML cleanup on MDX and JSX-like syntax. Use the explicit safe-html flag for strings that are known to contain HTML and should always be sanitized, including SVG or MathML snippets.

Bemerkung

Im Gegensatz zu den meisten anderen Formaten werden die Änderungen in den Übersetzungsdateien nicht in Weblate importiert, da dies nicht zuverlässig möglich ist. Die Quelle der Wahrheit für die Übersetzungen ist Weblate, nicht die übersetzte Datei.

Siehe auch

MDX

Beispieldatei:

---
title: Ahoj světe!
description: Learn with Weblate
---

import LessonCard from "./LessonCard"
export const metadata = { slug: "intro" }

# Ahoj světe!

<LessonCard title="Keep this code" count={5}>
  Do not translate this JSX body.
</LessonCard>

Orangutan has five bananas.

Try Weblate at [weblate.org](https://demo.weblate.org/)!

*Thank you for using Weblate.*

Unterstützte Funktionen¶
Dateiendungen	`.mdx`
Linguistik: ⓘ	Einsprachig
Unterstützt Pluralformen ⓘ	`No`
Unterstützt Beschreibungen ⓘ	`No`
Unterstützt Erklärung ⓘ	`No`
Unterstützt Kontext ⓘ	`No`
Unterstützt Ort ⓘ	`No`
Unterstützt Markierungen ⓘ	`No`
API-Kennung	`mdx`
Unterstützt schreibgeschützte Zeichenketten ⓘ	`No`
Durch dieses Format hinzugefügte Überprüfungsmarkierungen ⓘ	`auto-safe-html`, `strict-same`, `md-text`

Weblate-Konfiguration¶

Typische Weblate-Komponentenkonfiguration
Dateimaske	`path/*.mdx`
Einsprachige Basissprachdatei	`path/en.mdx`
Vorlage für neue Übersetzungen	`path/en.mdx`
Dateiformat	MDX-Datei
Dateiformat-Parameter	`mdx_merge_duplicates=True`

Behandlung doppelter Zeichenketten¶

Standardmäßig behandelt Weblate jedes Vorkommen einer Zeichenkette als separate Übersetzungseinheit, um einen zeilenbasierten Kontext bereitzustellen. Dies kann in MDX-Tabellen oder bei sich wiederholenden Komponenten problematisch sein, da sich durch das Neuanordnen der Kontext verändert und Übersetzungsverluste entstehen können.

Um identische Zeichenketten in einer einzigen Übersetzungseinheit zusammenzufassen, aktivieren Sie Identische Zeichenketten deduplizieren in Dateiformat-Parameter.

Bemerkung

Durch Aktivieren dieser Option wird der zeilenbasierte Kontext für die zusammengeführten Einheiten deaktiviert, wodurch sichergestellt wird, dass die Übersetzungen konsistent bleiben, selbst wenn Zeilen oder Abschnitte innerhalb des Dokuments verschoben werden.