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

# Файлы MDX

#### Versionadded
Добавлено в версии 2026.5.

#### NOTE
Поддержка этого формата находится в стадии разработки. Некоторые функции могут быть ещё недоступны, и поведение может меняться в зависимости от выпуска. Отзывы о тестировании приветствуются.

Файлы MDX — это файлы Markdown с синтаксисом JSX. Weblate извлекает переводимый текст Markdown и сохраняет импорты, экспорты, компоненты JSX и выражения.

Единицы MDX автоматически получают флаги `md-text`, `auto-safe-html`, `strict-same` и `safe-mdx`. Это сохраняет проверку небезопасного HTML активной для обычного текста, стандартного HTML и пользовательских элементов, избегая очистки HTML для синтаксиса MDX и подобного JSX. Используйте явный флаг `safe-html` для строк, которые, как известно, содержат HTML и всегда должны быть очищены, включая фрагменты SVG или MathML.

#### NOTE
В отличие от большинства других форматов, изменения в файлах перевода не будут импортированы в Weblate, поскольку это невозможно сделать надёжно. Источником достоверности переводов является Weblate, а не переведённый файл.

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

Пример файла:

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

#### Поддерживаемые функции

| Расширения файлов                                                                                        | `.mdx`                                                                                                                   |
|----------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------|
| Языковость [ⓘ](https://docs.weblate.org/ru/latest/formats.md#bimono)                                       | Одноязычный                                                                                                              |
| Поддерживает множественное число [ⓘ](https://docs.weblate.org/ru/latest/formats.md#format-plurals)         | `No`                                                                                                                     |
| Поддерживает описания [ⓘ](https://docs.weblate.org/ru/latest/formats.md#format-description)                | `No`                                                                                                                     |
| Поддерживает пояснения [ⓘ](https://docs.weblate.org/ru/latest/formats.md#format-explanation)               | `No`                                                                                                                     |
| Поддерживает контекст [ⓘ](https://docs.weblate.org/ru/latest/formats.md#format-context)                    | `No`                                                                                                                     |
| Поддерживает расположение [ⓘ](https://docs.weblate.org/ru/latest/formats.md#format-location)               | `No`                                                                                                                     |
| Поддерживает флаги [ⓘ](https://docs.weblate.org/ru/latest/formats.md#format-flags)                         | `No`                                                                                                                     |
| Идентификатор API                                                                                        | `mdx`                                                                                                                    |
| Поддерживает строки только для чтения [ⓘ](https://docs.weblate.org/ru/latest/formats.md#read-only-strings) | `No`                                                                                                                     |
| Поддерживает удаление устаревших строк [ⓘ](https://docs.weblate.org/ru/latest/formats.md#obsolete-strings) | `No`                                                                                                                     |
| Флаги проверки, добавляемые этим форматом [ⓘ](https://docs.weblate.org/ru/latest/admin/checks.md#custom-checks) | `auto-safe-html`, `strict-same`, `md-text`, [Безопасный MDX](https://docs.weblate.org/ru/latest/user/checks.md#check-safe-mdx) |
<!-- AUTOGENERATED END: format-features mdx -->

## Настройка Weblate

|                            | Типичный [Настройки компонента](https://docs.weblate.org/ru/latest/admin/projects.md#component) Weblate   |
|----------------------------|--------------------------------------------------------------------------------------------------|
| Маска файла                | `path/*.mdx`                                                                                     |
| Одноязычный базовый файл   | `path/en.mdx`                                                                                    |
| Шаблон для новых переводов | `path/en.mdx`                                                                                    |
| Формат файла               | Файл MDX                                                                                         |
| Параметры формата файла    | `mdx_merge_duplicates=True`                                                                      |

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

## Обработка дублирующихся строк

По умолчанию Weblate обрабатывает каждое вхождение строки как отдельную единицу перевода для обеспечения построчного контекста. Это может быть проблематично в таблицах MDX или повторяющемся содержимом компонентов, где переупорядочивание изменяет контекст и может привести к потере перевода.

Чтобы объединить идентичные строки в одну единицу перевода, включите Дедупликация идентичных строк в [Параметры формата файла](https://docs.weblate.org/ru/latest/admin/projects.md#component-file-format-params).

#### NOTE
Включение этой опции отключает построчный контекст для объединённых единиц, гарантируя, что переводы остаются стабильными, даже если строки или разделы перемещаются в документе.