Markdown 檔案

在 5.0 版被加入.

備註

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

從 Markdown 檔案中提取可翻譯內容並供翻譯。對於含 JSX 語法的 Markdown 檔案，使用 MDX 檔案。

Markdown 單元會自動取得 md-text、auto-safe-html 及 strict-same 旗標。這能讓純文字、標準 HTML 及自訂元素繼續接受不安全 HTML 檢查，同時避免清理 MDX 或類 JSX 元件等非 HTML 的尖括號語法。已知含有 HTML 且應一律清理的字串（包括 SVG 或 MathML 片段），請明確加上 safe-html 旗標。

備註

與多數其他格式不同，翻譯檔案中的變更不會匯入 Weblate，因為這無法可靠進行。翻譯應以 Weblate 為準，而不是以翻譯檔案為準。

也參考

Markdown

範例檔案：

# Ahoj světe!

Orangutan has five bananas.

Try Weblate at [weblate.org](https://demo.weblate.org/)!

*Thank you for using Weblate.*

支援的功能

副檔名	.markdown, .md
語言能力 ⓘ	單語言
支援複數 ⓘ	No
支援描述 ⓘ	No
支援解釋 ⓘ	No
支援情境 ⓘ	No
支援位置 ⓘ	No
支援旗標 ⓘ	No
API 辨識碼	markdown
支援唯讀字串 ⓘ	No
支援移除已不再使用的字串 ⓘ	No
檢查此格式新增的標記 ⓘ	auto-safe-html, strict-same, md-text

Weblate 設定

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

處理重複字串

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

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

備註

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

翻譯前置內容值

根據預設，YAML 前置內容會擷取為單一可翻譯區塊。在 檔案格式參數 中啟用 Translate front matter values，即可剖析 YAML 前置內容並僅翻譯純量字串值，同時盡可能保留鍵、結構、註解及格式。MDX 檔案 檔案也可使用相同設定。