MDX 檔案

在 2026.5 版被加入.

備註

此格式的支援尚在開發中。某些功能可能尚未提供，行為也可能隨發行版本而改變。歡迎提供測試意見。

MDX 檔案是使用 JSX 語法的 Markdown 檔案。Weblate 會擷取可翻譯的 Markdown 文字，並保留匯入、匯出、JSX 元件及運算式。

MDX 單元自動獲得 md-text、auto-safe-html、strict-same 和 safe-mdx 標記。這使不安全 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
語言能力 ⓘ	單語言
支援複數 ⓘ	No
支援描述 ⓘ	No
支援解釋 ⓘ	No
支援情境 ⓘ	No
支援位置 ⓘ	No
支援旗標 ⓘ	No
API 辨識碼	mdx
支援唯讀字串 ⓘ	No
支援移除已不再使用的字串 ⓘ	No
檢查此格式新增的標記 ⓘ	auto-safe-html 、 strict-same 、 md-text 、 安全的 MDX

Weblate 設定

典型的 Weblate 元件設定
檔案遮罩	path/*.mdx
單語言基底語言檔案	path/en.mdx
新翻譯的範本	path/en.mdx
檔案格式	MDX 檔案
檔案格式參數	mdx_merge_duplicates=True

處理重複字串

Weblate 預設將字串的每次出現視為不同的翻譯單元來提供基於行的情境。在 MDX 表格或重複的元件內容中可能會有問題，因為調整行順序會改變情境，導致譯文丟失。

若要將相同字串整合成單一翻譯單元，請在 檔案格式參數 中啟用 合併相同字串。

備註

啟用此選項會停用合併單元的逐行情境，確保即使文件內的資料列或章節移動，翻譯仍維持穩定。