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

# Markdown datoteke

#### Versionadded
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](https://docs.weblate.org/hr/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
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.

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

Example file:

```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. -->

#### Podržane funkcije

| Datotečni sufiks                                                                                           | `.markdown`, `.md`                         |
|------------------------------------------------------------------------------------------------------------|--------------------------------------------|
| Jezičnost [ⓘ](https://docs.weblate.org/hr/latest/formats.md#bimono)                                          | Jednojezične                               |
| Podržava množinu [ⓘ](https://docs.weblate.org/hr/latest/formats.md#format-plurals)                           | `No`                                       |
| Podržava opise [ⓘ](https://docs.weblate.org/hr/latest/formats.md#format-description)                         | `No`                                       |
| Podržava objašnjenja [ⓘ](https://docs.weblate.org/hr/latest/formats.md#format-explanation)                   | `No`                                       |
| Podržava kontekst [ⓘ](https://docs.weblate.org/hr/latest/formats.md#format-context)                          | `No`                                       |
| Podržava mjesto [ⓘ](https://docs.weblate.org/hr/latest/formats.md#format-location)                           | `No`                                       |
| Podržava oznake [ⓘ](https://docs.weblate.org/hr/latest/formats.md#format-flags)                              | `No`                                       |
| Identifikator API-ja                                                                                       | `markdown`                                 |
| Podržava izraze koji su samo-za-čitanje [ⓘ](https://docs.weblate.org/hr/latest/formats.md#read-only-strings) | `No`                                       |
| Supports removing obsolete strings [ⓘ](https://docs.weblate.org/hr/latest/formats.md#obsolete-strings)       | `No`                                       |
| Provjeri oznake koje je dodao ovaj format [ⓘ](https://docs.weblate.org/hr/latest/admin/checks.md#custom-checks)   | `auto-safe-html`, `strict-same`, `md-text` |
<!-- AUTOGENERATED END: format-features markdown -->

## Weblate konfiguracija

|                                       | Typical Weblate [Konfiguracija komponente](https://docs.weblate.org/hr/latest/admin/projects.md#component)   |
|---------------------------------------|-----------------------------------------------------------------------------------------------------|
| 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`                                                                    |

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

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

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

<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
[Parametri formata datoteke](https://docs.weblate.org/hr/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/hr/latest/formats/mdx.md#mdx) files.