<a id="markdown"></a>

# Fitxers Markdown

#### Versionadded
Afegit a la versió 5.0.

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](https://docs.weblate.org/ca/latest/formats/mdx.md#mdx).

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.

#### NOTE
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.

#### SEE ALSO
[Markdown](https://docs.translatehouse.org/projects/translate-toolkit/en/latest/formats/md.html)

Fitxer d’exemple:

```md
# Ahoj světe!

Orangutan has five bananas.

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

*Thank you for using Weblate.*
```

<!-- AUTOGENERATED START: format-features markdown -->
<!-- This section is automatically generated by `./manage.py list_format_features`. Do not edit manually. -->

#### Supported features

| File extensions                                                                                      | `.markdown`, `.md`                         |
|------------------------------------------------------------------------------------------------------|--------------------------------------------|
| Lingualitat [ⓘ](https://docs.weblate.org/ca/latest/formats.md#bimono)                                  | Monolingual                                |
| Supports plural [ⓘ](https://docs.weblate.org/ca/latest/formats.md#format-plurals)                      | `No`                                       |
| Supports descriptions [ⓘ](https://docs.weblate.org/ca/latest/formats.md#format-description)            | `No`                                       |
| Admet l’explicació [ⓘ](https://docs.weblate.org/ca/latest/formats.md#format-explanation)               | `No`                                       |
| Supports context [ⓘ](https://docs.weblate.org/ca/latest/formats.md#format-context)                     | `No`                                       |
| Supports location [ⓘ](https://docs.weblate.org/ca/latest/formats.md#format-location)                   | `No`                                       |
| Supports flags [ⓘ](https://docs.weblate.org/ca/latest/formats.md#format-flags)                         | `No`                                       |
| API identifier                                                                                       | `markdown`                                 |
| Admet cadenes de només lectura [ⓘ](https://docs.weblate.org/ca/latest/formats.md#read-only-strings)    | `No`                                       |
| Supports removing obsolete strings [ⓘ](https://docs.weblate.org/ca/latest/formats.md#obsolete-strings) | `No`                                       |
| Check flags added by this format [ⓘ](https://docs.weblate.org/ca/latest/admin/checks.md#custom-checks)      | `auto-safe-html`, `strict-same`, `md-text` |
<!-- AUTOGENERATED END: format-features markdown -->

## Configuració del Weblate

|                                   | Placa web típica [Configuració dels components](https://docs.weblate.org/ca/latest/admin/projects.md#component)   |
|-----------------------------------|----------------------------------------------------------------------------------------------------------|
| 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`                                                                         |

<a id="markdown-duplicates"></a>

## 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](https://docs.weblate.org/ca/latest/admin/projects.md#component-file-format-params).

#### NOTE
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.

<a id="markdown-frontmatter-values"></a>

## 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](https://docs.weblate.org/ca/latest/admin/projects.md#component-file-format-params) 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](https://docs.weblate.org/ca/latest/formats/mdx.md#mdx) files.