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

## Panoramica [#overview]

| Argomento                                     | Descrizione                                                 |
| --------------------------------------------- | ----------------------------------------------------------- |
| [Configurazione](#config)                     | Seleziona i file sorgente e i percorsi di output tradotti.  |
| [Esportazione di dati statici](#data-exports) | Riutilizza le stringhe invariate nelle esportazioni idonee. |
| [Nomi dei file tradotti](#transform)          | Rimappa i nomi dei file di output con `transform`.          |
| [Link e risorse](#localize)                   | Localizza URL, importazioni e risorse relative.             |

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

## Aggiorna le esportazioni di dati statici [#data-exports]

Quando un file MDX aggiornato contiene esportazioni di dati statici, General Translation riutilizza le stringhe corrispondenti dalle traduzioni precedenti e traduce solo le stringhe nuove o modificate. Il riutilizzo si applica quando ogni variabile esportata nel blocco contiene solo valori letterali statici di stringa, numero, bigint, booleani o `null`, array e oggetti semplici. I wrapper di asserzione TypeScript sono supportati.

Le esportazioni con spread, identificatori, chiamate di funzione, template literals o JSX, oppure con chiavi di oggetti calcolate, usano il percorso di traduzione standard. L'esecuzione di [`gt translate --force`](/docs/cli/reference/commands/translate) o l'applicazione delle traduzioni del Glossario ignorano anch'esse il riutilizzo incrementale.

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