Fitxers Markdown

Afegit a la versió 5.0.

Nota

El suport per a aquest format està en desenvolupament. És possible que algunes funcions encara no estiguin disponibles i el comportament pot canviar entre les versions. Els comentaris de les proves són benvinguts.

El contingut traduïble s’extreu dels fitxers Markdown i s’ofereix per a la traducció. Per als fitxers Markdown amb sintaxi JSX, utilitzeu 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.

Nota

A diferència de la majoria dels altres formats, els canvis en els fitxers de traducció no s’importaran a Weblate perquè no es poden fer de manera fiable. La font de veritat de les traduccions és Weblate, no el fitxer traduït.

Vegeu també

Markdown

Fitxer d’exemple:

# Ahoj světe!

Orangutan has five bananas.

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

*Thank you for using Weblate.*

Supported features

File extensions	.markdown, .md
Lingualitat ⓘ	Monolingual
Supports plural ⓘ	No
Supports descriptions ⓘ	No
Admet l’explicació ⓘ	No
Supports context ⓘ	No
Supports location ⓘ	No
Supports flags ⓘ	No
API identifier	markdown
Admet cadenes de només lectura ⓘ	No
Supports removing obsolete strings ⓘ	No
Check flags added by this format ⓘ	auto-safe-html, strict-same, md-text

Configuració del Weblate

Placa web típica Configuració dels components
Filtre de fitxers	path/*.md
Fitxer de llengua base monolingüe	path/en.md
Plantilla per a traduccions noves	path/en.md
Format de fitxer	Markdown file
Paràmetres del format de fitxer	markdown_merge_duplicates=True

Handling duplicate strings

Per defecte, Weblate tracta cada ocurrència d’una cadena com una unitat de traducció independent per proporcionar un context basat en línies. Això pot ser problemàtic a les taules Markdown, on reordenar les files canvia el context i pot provocar una pèrdua de traducció.

Per consolidar cadenes idèntiques en una única unitat de traducció, activeu Deduplica cadenes idèntiques a Paràmetres del format de fitxer.

Nota

Si activeu aquesta opció, es desactiva el context basat en línies per a les unitats combinades, assegurant que les traduccions es mantenen estables encara que les files o les seccions es moguin dins del document.

Translating front matter values

By default, YAML front matter is extracted as a single translatable block. Enable Translate front matter values in Paràmetres del format de fitxer 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.