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

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