MDX files

Added in version 2026.5.

Napomena

Support for this format is under development. Some features might not yet be available and the behavior can change between releases. Feedback from testing is welcome.

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, auto-safe-html, strict-same and safe-mdx 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.

Napomena

Unlike most other formats, the changes in the translation files will not be imported to Weblate because it can not be done reliably. The source of truth for the translations is Weblate not the translated file.

Više informacija

MDX

Example file:

---
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.*
Podržane funkcije

Datotečni sufiks

.mdx

Jezičnost ⓘ

Jednojezične

Podržava množinu ⓘ

No

Podržava opise ⓘ

No

Podržava objašnjenja ⓘ

No

Podržava kontekst ⓘ

No

Podržava mjesto ⓘ

No

Podržava oznake ⓘ

No

Identifikator API-ja

mdx

Podržava izraze koji su samo-za-čitanje ⓘ

No

Supports removing obsolete strings ⓘ

No

Provjeri oznake koje je dodao ovaj format ⓘ

auto-safe-html, strict-same, md-text, Safe MDX

Weblate konfiguracija

Typical Weblate Konfiguracija komponente

Maska datoteke

path/*.mdx

Jednojezična datoteka osnovnog jezika

path/en.mdx

Predložak za nove prijevode

path/en.mdx

Format datoteke

MDX file

Parametri formata datoteke

mdx_merge_duplicates=True

Baratanje duplim izrazima

By default, Weblate treats each occurrence of a string as a separate translation unit to provide line-based context. This can be problematic in MDX tables or repeated component content, where reordering changes the context and can lead to translation loss.

To consolidate identical strings into a single translation unit, enable Deduplicate identical strings in the Parametri formata datoteke.

Napomena

Enabling this option disables line-based context for the merged units, ensuring that translations remain stable even if rows or sections are moved within the document.