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

title: MDX et Markdown
description: Traduisez des fichiers MDX et Markdown avec la CLI de General Translation. Référence API des formats de fichier MDX et Markdown.

---

La CLI traduit les fichiers MDX (`mdx`) et Markdown (`md`). Toute la syntaxe et la mise en forme des fichiers source sont préservées dans les fichiers traduits.

## Configuration [#config]

Ajoutez une entrée `mdx` ou `md` dans `files`, avec un tableau `include` contenant des motifs glob. Utilisez l’espace réservé `[locale]` pour que le CLI puisse trouver les fichiers source et enregistrer les traductions au bon emplacement.

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

Cela traduit chaque fichier MDX dans `content/docs/en` et enregistre les résultats dans `content/docs/ja`. Utilisez plutôt la clé `md` pour les fichiers Markdown. Consultez la [référence de configuration](/docs/cli/reference/config#files) pour connaître toutes les clés de fichier.

## Mettre à jour les exports de données statiques [#data-exports]

Lorsqu’un fichier MDX mis à jour contient des exports de données statiques, General Translation réutilise les chaînes correspondantes issues de traductions antérieures et ne traduit que les chaînes nouvelles ou modifiées. Cette réutilisation s’applique aux variables exportées dont les valeurs ne contiennent que des littéraux, des tableaux et des objets simples. Les exports qui utilisent des spreads, des identifiants, des appels de fonction, des littéraux de gabarit ou du JSX suivent le flux de traduction standard.

La retraduction forcée et la retraduction du glossaire n’utilisent pas cette réutilisation incrémentielle.

## Renommer les fichiers traduits [#transform]

La clé `transform` remappe les noms des fichiers de sortie. Dans l’exemple ci-dessus, `*.[locale].mdx` transforme l’extension des fichiers traduits en `.ja.mdx`. Utilisez cette option lorsque votre framework de documentation attend un paramètre régional dans le nom du fichier plutôt que dans le chemin du répertoire.

## Localiser les liens et les ressources [#localize]

Plusieurs options expérimentales de [`gt translate`](/docs/cli/reference/commands/translate#experimental) s’appliquent spécifiquement à la sortie `md` et `mdx` :

* `--experimental-localize-static-urls` — localise les URL dans les fichiers traduits.
* `--experimental-localize-static-imports` — localise les imports statiques dans les fichiers traduits.
* `--experimental-localize-relative-assets` — réécrit les URL relatives des ressources image dans les fichiers traduits.
* `--experimental-hide-default-locale` — masque le paramètre régional par défaut dans les chemins localisés.