MDX files¶

Added in version 2026.5.

Observera

Stöd för detta format är under utveckling. Vissa funktioner kanske ännu inte är tillgängliga och funktionen kan ändras mellan olika versioner. Feedback från testning är välkommen.

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.

Observera

Till skillnad från de flesta andra format kommer ändringarna i översättningsfilerna inte att importeras till Weblate, eftersom det inte kan göras på ett tillförlitligt sätt. Källan till översättningarna är Weblate, inte den översatta filen.

Se även

MDX

Exempelfil:

---
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.*

Stödda funktioner¶
File extensions	`.mdx`
Linguality ⓘ	Monolingual
Supports plural ⓘ	`No`
Supports descriptions ⓘ	`No`
Supports explanation ⓘ	`No`
Supports context ⓘ	`No`
Supports location ⓘ	`No`
Supports flags ⓘ	`No`
API identifier	`mdx`
Supports read-only strings ⓘ	`No`
Check flags added by this format ⓘ	`auto-safe-html`, `strict-same`, `md-text`

Weblate-konfiguration¶

Typisk Weblate Komponentkonfiguration
Filmask	`path/*.mdx`
Enspråkig basspråkfil	`path/en.mdx`
Mall för nya översättningar	`path/en.mdx`
Filformat	MDX file
Filformatsparametrar	`mdx_merge_duplicates=True`

Handling duplicate strings¶

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 Filformatsparametrar.

Observera

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.