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

title: MDX y Markdown
description: Traduce archivos MDX y Markdown con la CLI de General Translation. Referencia de API para los formatos de archivo MDX y Markdown.

---

La CLI traduce archivos MDX (`mdx`) y Markdown (`md`). Toda la sintaxis y el formato de los archivos fuente se conservan en los archivos traducidos.

## Configuración [#config]

Añade una entrada `mdx` o `md` dentro de `files` con una lista `include` de patrones glob. Usa el marcador de posición `[locale]` para que la CLI pueda encontrar los archivos fuente y guardar las traducciones en la ruta correcta.

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

Esto traduce todos los archivos MDX de `content/docs/en` y guarda los resultados en `content/docs/ja`. Usa la clave `md` en su lugar para archivos Markdown. Consulta la [referencia de configuración](/docs/cli/reference/config#files) para ver todas las claves de archivo.

## Cambiar el nombre de los archivos traducidos [#transform]

La clave `transform` remapea los nombres de los archivos de salida. En el ejemplo anterior, `*.[locale].mdx` cambia la extensión del archivo traducido a `.ja.mdx`. Úsalo cuando tu framework de documentación espera una configuración regional en el nombre del archivo, en lugar de en la ruta del directorio.

## Localiza enlaces y recursos [#localize]

Varias opciones experimentales de [`gt translate`](/docs/cli/reference/commands/translate#experimental) se aplican específicamente a los archivos de salida `md` y `mdx`:

* `--experimental-localize-static-urls` — localiza las URL en los archivos traducidos.
* `--experimental-localize-static-imports` — localiza las importaciones estáticas en los archivos traducidos.
* `--experimental-localize-relative-assets` — reescribe las URL relativas de recursos de imagen en los archivos traducidos.
* `--experimental-hide-default-locale` — oculta la configuración regional predeterminada en las rutas localizadas.