# gt: General Translation CLI tool: MDX и Markdown
URL: https://generaltranslation.com/ru/docs/cli/reference/formats/mdx-md-files.mdx
---

title: MDX и Markdown
description: Переводите файлы MDX и Markdown с помощью CLI General Translation. Справочник API по форматам файлов MDX и Markdown.

---

CLI переводит файлы MDX (`mdx`) и Markdown (`md`). Весь синтаксис и форматирование в исходных файлах сохраняются в переведённых файлах.

## Конфигурация [#config]

Добавьте запись `mdx` или `md` в `files`, указав для `include` массив glob-шаблонов. Используйте заполнитель `[locale]`, чтобы CLI мог находить исходные файлы и сохранять переводы по нужному пути.

```json title="gt.config.json"
{
  "defaultLocale": "en",
  "locales": ["ja"],
  "files": {
    "mdx": {
      "include": ["content/docs/[locale]/**/*.mdx"],
      "transform": "*.[locale].mdx"
    }
  }
}
```

Это переводит все MDX-файлы в `content/docs/en` и сохраняет результаты в `content/docs/ja`. Для Markdown-файлов вместо этого используйте ключ `md`. Все ключи файлов см. в [справочнике по конфигурации](/docs/cli/reference/config#files).

## Переименование переведённых файлов [#transform]

Ключ `transform` переопределяет имена выходных файлов. В примере выше `*.[locale].mdx` меняет расширение переведённого файла на `.ja.mdx`. Используйте это, если ваш фреймворк документации ожидает локаль в имени файла, а не в пути к директории.

## Локализация ссылок и ресурсов [#localize]

Несколько экспериментальных флагов [`gt translate`](/docs/cli/reference/commands/translate#experimental) применяются только к выводу в форматах `md` и `mdx`:

* `--experimental-localize-static-urls` — локализует URL-адреса в переведённых файлах.
* `--experimental-localize-static-imports` — локализует статические импорты в переведённых файлах.
* `--experimental-localize-relative-assets` — переписывает относительные URL-адреса изображений в переведённых файлах.
* `--experimental-hide-default-locale` — убирает локаль по умолчанию из локализованных путей.