Markdown 文件

Added in version 5.0.

备注

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

The translatable content is extracted from the Markdown files and offered for the translation. For Markdown files with JSX syntax, use MDX files.

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

备注

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

参见

Markdown

示例文件：

# Ahoj světe!

Orangutan has five bananas.

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

*Thank you for using Weblate.*

支持的功能

文件扩展名	.md
Linguality ⓘ	单语言
支持复数 ⓘ	No
支持描述 ⓘ	No
支持解释 ⓘ	No
支持上下文 ⓘ	No
支持位置 ⓘ	No
支持标记 ⓘ	No
API 标识符	markdown
支持只读字符串 ⓘ	No
Check flags added by this format ⓘ	auto-safe-html, strict-same, md-text

Weblate 配置

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

处理重复的字符串

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

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

备注

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