Markdown datoteke

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 units automatically get the md-text, auto-safe-html and strict-same flags. This keeps the unsafe HTML check active for plain text, standard HTML, and custom elements while avoiding HTML cleanup on non-HTML angle-bracket syntax such as MDX or JSX-like components. Use the explicit safe-html flag for strings that are known to contain HTML and should always be sanitized, including SVG or MathML snippets.

Napomena

Unlike most other formats, the changes in the translation files will not be imported to Weblate because it can not be done reliably. The source of truth for the translations is Weblate not the translated file.

Više informacija

Markdown

Example file:

# Ahoj světe!

Orangutan has five bananas.

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

*Thank you for using Weblate.*

Podržane funkcije

Datotečni sufiks	.markdown, .md
Jezičnost ⓘ	Jednojezične
Podržava množinu ⓘ	No
Podržava opise ⓘ	No
Podržava objašnjenja ⓘ	No
Podržava kontekst ⓘ	No
Podržava mjesto ⓘ	No
Podržava oznake ⓘ	No
Identifikator API-ja	markdown
Podržava izraze koji su samo-za-čitanje ⓘ	No
Supports removing obsolete strings ⓘ	No
Provjeri oznake koje je dodao ovaj format ⓘ	auto-safe-html, strict-same, md-text

Weblate konfiguracija

Typical Weblate Konfiguracija komponente
Maska datoteke	path/*.md
Jednojezična datoteka osnovnog jezika	path/en.md
Predložak za nove prijevode	path/en.md
Format datoteke	Markdown file
Parametri formata datoteke	markdown_merge_duplicates=True

Baratanje duplim izrazima

By default, Weblate treats each occurrence of a string as a separate translation unit to provide line-based context. This can be problematic in Markdown tables, where reordering rows changes the context and can lead to translation loss.

To consolidate identical strings into a single translation unit, enable Deduplicate identical strings in the Parametri formata datoteke.

Napomena

Enabling this option disables line-based context for the merged units, ensuring that translations remain stable even if rows or sections are moved within the document.

Translating front matter values

By default, YAML front matter is extracted as a single translatable block. Enable Translate front matter values in Parametri formata datoteke to parse YAML front matter and translate only scalar string values while preserving keys, structure, comments, and formatting when possible. The same setting is available for MDX files files.