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

title: MDX e Markdown
description: Traduci file MDX e Markdown con la CLI di General Translation. Riferimento API per i formati di file MDX e Markdown.

---

La CLI traduce file MDX (`mdx`) e Markdown (`md`). Tutta la sintassi e la formattazione dei file sorgente vengono preservate nei file tradotti.

## Configurazione [#config]

Aggiungi una voce `mdx` o `md` in `files` con un array `include` contenente pattern glob. Usa il segnaposto `[locale]` in modo che la CLI possa trovare i file sorgente e salvare le traduzioni nel percorso corretto.

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

In questo modo vengono tradotti tutti i file MDX in `content/docs/en` e i risultati vengono salvati in `content/docs/ja`. Per i file Markdown, usa invece la chiave `md`. Consulta il [riferimento della configurazione](/docs/cli/reference/config#files) per tutte le chiavi relative ai file.

## Rinomina i file tradotti [#transform]

La chiave `transform` rimappa i nomi dei file di output. Nell'esempio sopra, `*.[locale].mdx` fa sì che l'estensione tradotta diventi `.ja.mdx`. Usalo quando il framework di documentazione prevede un'impostazione regionale nel nome del file anziché nel percorso della directory.

## Localizza link e risorse [#localize]

Diversi flag sperimentali di [`gt translate`](/docs/cli/reference/commands/translate#experimental) si applicano in modo specifico all'output `md` e `mdx`:

* `--experimental-localize-static-urls` — localizza gli URL nei file tradotti.
* `--experimental-localize-static-imports` — localizza gli import statici nei file tradotti.
* `--experimental-localize-relative-assets` — riscrive gli URL relativi delle immagini nei file tradotti.
* `--experimental-hide-default-locale` — omette l'impostazione regionale predefinita dai percorsi localizzati.