MDX 文件¶

Added in version 2026.5.

备注

我们正在开发对这种格式的支持。某些功能也许上不可用，且不同版本间的行为也不一样。欢迎从测试得来的反馈。

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

MDX 单元自动获得 md-text 和 auto-safe-html 标记。这使不安全 HTML 勾选对纯文本、标准 HTML 和自定义元素生效，同时避免对 MDX 或类 JSX 语法的 HTML 清理。对已知包含 HTML 和应当始终被净化的字符串使用显式 safe-html 标记，包括 SVG 或 MathML 片段。

备注

和其他多数格式不同，翻译文件的更改不会被导入到 Weblate，因为无法可靠地完成这一任务。翻译真实性源自 Weblate 而不是已翻译的文件。

参见

MDX

示例文件：

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

支持的功能¶
文件扩展名	`.mdx`
Linguality ⓘ	单语言
支持复数 ⓘ	`No`
支持描述 ⓘ	`No`
支持解释 ⓘ	`No`
支持上下文 ⓘ	`No`
支持位置 ⓘ	`No`
支持标记 ⓘ	`No`
API 标识符	`mdx`
支持只读字符串 ⓘ	`No`
检查此格式添加的标记 ⓘ	`auto-safe-html`, `strict-same`, `md-text`

Weblate 配置¶

典型的 Weblate 部件配置
文件掩码	`path/*.mdx`
单语言译文模版语言文件	`path/en.mdx`
新语种的翻译模版	`path/en.mdx`
文件格式	MDX 文件
文件格式参数	`mdx_merge_duplicates=True`

处理重复的字符串¶

Weblate 默认将字符串的每次出现视为不同的翻译单元来提供基于行的上下文。在 MDX 表格或重复的部件内容中可能会有问题，因为调整行顺序会改变上下文，导致译文丢失。

整合相同字符串到单一翻译单元，在文件格式参数中启用 Deduplicate identical strings.

备注

启用此选项为已合并单元禁用基于行的上下文，确保即使行或部分在文档内移动译文也保持稳定。