<a id="mdx"></a>

# Ficheiros MDX

#### Versionadded
Added in version 2026.5.

#### NOTE
O apoio para este formato está em desenvolvimento. Alguns recursos podem não estar disponíveis ainda e o comportamento pode mudar entre as versões. O feedback dos testes é bem-vindo.

Ficheiros MDX são ficheiros Markdown com sintaxe JSX. O Weblate extrai texto Markdown traduzível e preserva importações, exportações, componentes JSX, e expressões.

Unidades MDX automaticamente possuem os marcadores `md-text`, `auto-safe-html`, `strict-same` e `safe-mdx`. Isto mantém a verificação de HTML inseguro ativo para texto simples, HTML padrão, e elementos personalizados enquanto que evita limpeza HTML e sintaxe MDX e do tipo JSX. Utilize o marcador `safe-html` explícito para cadeias de carateres que se sabe que contêm HTML e dever ser sempre validadas, incluíndo excertos SVG ou MathML.

#### NOTE
Ao contrário da maioria dos outros formatos, as alterações nos ficheiros de tradução não serão importadas para o Weblate porque isso não pode ser feito de forma confiável. A fonte da verdade para as traduções é o Weblate, não o ficheiro traduzido.

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

Exemplo de ficheiro:

```md
---
title: Ahoj světe!
description: Learn with Weblate
---

import LessonCard from "./LessonCard"
export const metadata = { slug: "intro" }

# Ahoj světe!

<LessonCard title="Keep this code" count={5}>
  Do not translate this JSX body.
</LessonCard>

Orangutan has five bananas.

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

*Thank you for using Weblate.*
```

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

#### Recursos suportados

| Extensões de ficheiro                                                                                                 | `.mdx`                                                                                                               |
|-----------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------|
| Lingualidade [ⓘ](https://docs.weblate.org/pt/latest/formats.md#bimono)                                                  | Monolingue                                                                                                           |
| Suporta plural [ⓘ](https://docs.weblate.org/pt/latest/formats.md#format-plurals)                                        | `No`                                                                                                                 |
| Suporta descrições [ⓘ](https://docs.weblate.org/pt/latest/formats.md#format-description)                                | `No`                                                                                                                 |
| Suporta explicação [ⓘ](https://docs.weblate.org/pt/latest/formats.md#format-explanation)                                | `No`                                                                                                                 |
| Suporta contexto [ⓘ](https://docs.weblate.org/pt/latest/formats.md#format-context)                                      | `No`                                                                                                                 |
| Suporta localização [ⓘ](https://docs.weblate.org/pt/latest/formats.md#format-location)                                  | `No`                                                                                                                 |
| Suporta marcadores [ⓘ](https://docs.weblate.org/pt/latest/formats.md#format-flags)                                      | `No`                                                                                                                 |
| Identificador API                                                                                                     | `mdx`                                                                                                                |
| Suporta cadeias de carateres apenas de leitura [ⓘ](https://docs.weblate.org/pt/latest/formats.md#read-only-strings)     | `No`                                                                                                                 |
| Suporta a remoção de cadeias de careteres obsoletas [ⓘ](https://docs.weblate.org/pt/latest/formats.md#obsolete-strings) | `No`                                                                                                                 |
| Marcadores de verificação adicionados por este formato [ⓘ](https://docs.weblate.org/pt/latest/admin/checks.md#custom-checks) | `auto-safe-html`, `strict-same`, `md-text`, [MDX Seguro](https://docs.weblate.org/pt/latest/user/checks.md#check-safe-mdx) |
<!-- AUTOGENERATED END: format-features mdx -->

## Configuração do Weblate

|                                    | [Configuração de componente](https://docs.weblate.org/pt/latest/admin/projects.md#component) típica do Weblate   |
|------------------------------------|---------------------------------------------------------------------------------------------------------|
| Máscara de ficheiros               | `path/*.mdx`                                                                                            |
| Ficheiro de idioma base monolingue | `path/en.mdx`                                                                                           |
| Modelo para novas traduções        | `path/en.mdx`                                                                                           |
| Formato de ficheiro                | Ficheiro MDX                                                                                            |
| Parâmetros de formato de ficheiro  | `mdx_merge_duplicates=True`                                                                             |

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

## Gerir cadeias de carateres duplicadas

Por predefinição, o Weblate trata cada ocorrência de uma cadeia de carateres como uma unidade de tradução separada para fornecer contexto baseado em linhas. Isto pode ser problemático para tabelas MDX, onde reordenar mudanças altera o contexto e pode levar a perda de tradução.

Para consolidar cadeias de carateres idênticas em uma única unidade de tradução, ative Deduplicar cadeias de carateres idênticas no [Parâmetros de formato de ficheiro](https://docs.weblate.org/pt/latest/admin/projects.md#component-file-format-params).

#### NOTE
Ativar esta opção desativa contexto baseado em linha para as unidade unidas, assegurando que traduções permanecem estáveis ainda que linhas ou secções sejam movidas para dentro do documento.