Archivos MDX¶

Added in version 2026.5.

Nota

La compatibilidad con este formato está en desarrollo. Es posible que algunas funciones aún no estén disponibles y el comportamiento puede cambiar entre versiones. Agradecemos sus comentarios sobre las pruebas.

Los archivos MDX son archivos de Markdown con sintaxis JSX. Weblate extrae texto Markdown traducible y conserva las importaciones, las exportaciones, los componentes JSX y las expresiones.

Las unidades MDX reciben automáticamente los indicadores md-text, auto-safe-html, strict-same y safe-mdx. De este modo, se mantiene activa la comprobación de HTML no seguro para el texto sin formato, el HTML estándar y los elementos personalizados, al tiempo que se evita la limpieza de HTML en la sintaxis MDX y similar a JSX. Use el indicador explícito safe-html para las cadenas que se sabe que contienen HTML y que siempre deben ser depuradas, incluidos los fragmentos de SVG o MathML.

Nota

A diferencia de la mayoría de los demás formatos, los cambios en los archivos de traducción no se importarán a Weblate porque no es fiable. La fuente de las traducciones es Weblate, no el archivo traducido.

Ver también

MDX

Archivo de ejemplo:

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

Características admitidas¶
Extensiones de archivo	`.mdx`
Lingüística ⓘ	Monolingüe
Admite plural ⓘ	`No`
Admite descripciones ⓘ	`No`
Admite explicación ⓘ	`No`
Admite contexto ⓘ	`No`
Admite lugar ⓘ	`No`
Admite indicadores ⓘ	`No`
Identificador de API	`mdx`
Admite cadenas de solo lectura en ⓘ	`No`
Admite retirar cadenas obsoletas ⓘ	`No`
Indicadores de marcador añadidos por este formato ⓘ	`auto-safe-html`, `strict-same`, `md-text`, Guardar MDX

Configuración de Weblate¶

Weblate típico Configuración de componentes
Máscara de archivos	`path/*.mdx`
Archivo de base monolingüe	`path/en.mdx`
Plantilla para traducciones nuevas	`path/en.mdx`
Formato de archivo	Archivo MDX
Parámetros del formato de archivo	`mdx_merge_duplicates=True`

Manipula cadenas duplicadas¶

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.

Para consolidar cadenas idénticas en una sola unidad de traducción, habilite Desduplicar cadenas idénticas en Parámetros del formato de archivo.

Nota

Al habilitar esta opción se inhabilita el contexto basado en líneas para las unidades fusionadas, lo que garantiza que las traducciones permanezcan estables incluso si se mueven filas o secciones dentro del documento.