# gt: General Translation CLI tool: MDX y Markdown
URL: https://generaltranslation.com/es/docs/cli/reference/formats/mdx-md-files.mdx
Docs index: https://generaltranslation.com/llms.txt
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.

## Resumen [#overview]

| Tema                                              | Descripción                                                                    |
| ------------------------------------------------- | ------------------------------------------------------------------------------ |
| [Configuración](#config)                          | Selecciona archivos fuente y rutas de salida de los archivos traducidos.       |
| [IDs de encabezado personalizados](#heading-ids)  | Conserva los anclajes explícitos de los encabezados.                           |
| [Exportaciones de datos estáticos](#data-exports) | Reutiliza cadenas sin cambios en las exportaciones que cumplan los requisitos. |
| [Nombres de archivos traducidos](#transform)      | Modifica los nombres de los archivos de salida con `transform`.                |
| [Enlaces y recursos](#localize)                   | Localiza URL, importaciones y recursos relativos.                              |

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

## ID de encabezado personalizados [#heading-ids]

Los sufijos `{#id}` al estilo de Mintlify se mantienen unidos a sus encabezados después de la traducción:

```markdown
## Configura el cliente {#configure-client}
```

Los ID de encabezado explícitos requieren `gt` 2.17.3 o posterior.

Cuando `experimentalAddHeaderAnchorIds` tiene el valor `'mintlify'`, la CLI escribe la sintaxis nativa de Mintlify `{#id}` en cada encabezado traducido y reutiliza el ID del encabezado de origen. Los encabezados anidados en JSX se desplazan al margen cuando es necesario, ya que Mintlify solo reconoce el sufijo en encabezados con un máximo de tres espacios iniciales. Este modo requiere `gt` 2.20.4 o posterior.

## Actualizar las exportaciones de datos estáticos [#data-exports]

Cuando un archivo MDX actualizado contiene exportaciones de datos estáticos, General Translation reutiliza las cadenas que coinciden de traducciones anteriores y traduce solo las cadenas nuevas o modificadas. La reutilización se aplica cuando todas las variables exportadas del fragmento contienen únicamente literales estáticos de cadena, número, bigint, booleano o `null`, listas y objetos simples. Se admiten envoltorios de aserción de TypeScript.

Las exportaciones con spreads, identificadores, llamadas a funciones, literales de plantilla, JSX o claves de objeto calculadas usan la ruta de traducción estándar. Ejecutar [`gt translate --force`](/docs/cli/reference/commands/translate) o aplicar traducciones del glosario también omite la reutilización incremental.

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

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.