---
title: "Traducir archivos YAML y TOML"
description: "Traduce archivos .yaml, .yml y .toml de hasta 4 MB a uno o varios idiomas. Las claves, la jerarquía y el orden se conservan. Ejemplos de instrucciones para Rails, Hugo y archivos de configuración."
canonical: "https://ai-glot.com/docs/es/formats/yaml-and-toml"
updated: "2026-10-12"
---

# Traducir archivos YAML y TOML

Se aceptan archivos YAML (`.yaml`, `.yml`) y TOML (`.toml`) de hasta **4 MB**. Solo se modifican los valores de texto: las claves, los niveles de anidación, las tablas y el orden de las claves se conservan. Entre los usos habituales están los archivos de idioma de Rails y Symfony, el contenido para sitios estáticos y las tablas i18n de Hugo.

> **Tip: Pruébalo gratis**
>
> Arrastra un archivo de hasta 2 MB a los traductores gratuitos de [YAML](https://ai-glot.com/file-formats/yaml-translation) o [TOML](https://ai-glot.com/file-formats/toml-translation) para probarlos sin cuenta, con un límite de cinco archivos al día. La aplicación, la API y la CLI aceptan archivos de hasta 4 MB.

## Qué se traduce y qué se deja intacto

|      | Se traduce                                                                 | Se deja intacto                                                     |
| ---- | -------------------------------------------------------------------------- | ------------------------------------------------------------------- |
| YAML | Valores de texto, incluido el contenido en prosa de los bloques multilínea | Claves, jerarquía, orden de las claves, números y valores booleanos |
| TOML | Valores de texto, cada uno sustituido en su propia línea                   | Tablas, claves, orden, comentarios, números, fechas y rutas         |

Los marcadores de posición, como `%{name}` (Rails), `{name}` y `%s`, están protegidos y se conservan en el texto traducido.

## Qué puedes pedir

**Un archivo de idioma de Rails**

Un idioma, con los marcadores de interpolación y todas las claves intactos.

Traduce los valores al francés. Mantén %\{name} y %\{count} sin cambios y no modifiques ninguna clave.

**Completar las secciones de idioma**

Para un archivo YAML que ya tiene una sección por idioma: varios idiomas en un solo trabajo.

Completa las secciones fr y de vacías a partir de la sección en.

**Front matter y contenido**

Para un sitio estático: traduce el texto y deja intactos los ajustes.

Traduce solo los campos title, description y body al italiano. Deja intactos los slugs, las fechas, los diseños y las URLs.

**Una tabla i18n de Hugo**

Para TOML: conserva las claves que utilizan las plantillas.

Traduce las cadenas al portugués. Mantén exactamente todas las claves y los nombres de las tablas.

**Solo las claves modificadas**

Para YAML: devuelve únicamente las claves que se hayan editado.

Traduce los valores al francés y devuelve solo las claves que hayas cambiado.

**Texto dirigido a usuarios en un archivo de configuración**

Deja intactos los ajustes.

Traduce solo los mensajes y las etiquetas que leen las personas al alemán. Deja intactos los ajustes, identificadores, rutas y números.

## Conviene saber

- **Varios idiomas en un mismo trabajo.** TOML admite varios idiomas: el plan añade junto a cada clave original otra clave con un sufijo de idioma, como `hello_fr`. YAML admite varios idiomas cuando el archivo ya tiene una sección para cada uno (`en:`, `fr:`, `de:`). Un archivo típico de Rails con una única raíz `en:` requiere un idioma por subida. Si pides más, puede que el plan no se pueda preparar. Procesa el archivo una vez por idioma: tu [glosario](/docs/platform/glossaries) se conserva.
- **Filtro de salida.** Disponible para YAML («solo las claves que hayas cambiado»). TOML devuelve el archivo completo.
- **Los comentarios YAML no se conservan.** El archivo se lee como datos y se vuelve a escribir como YAML limpio: se eliminan los comentarios y la sangría y las comillas se normalizan a dos espacios. Conserva el archivo original con comentarios como referencia. Los anclajes siguen siendo válidos, aunque sus nombres pueden cambiar.
- **Normalmente, los comentarios TOML se conservan**, porque cada cadena se sustituye en su propia línea. Si un valor no se puede colocar así, por ejemplo, si está dentro de una tabla en línea, el archivo se vuelve a escribir con un formato normalizado y se eliminan los comentarios. El plan te avisa cuando esto ocurre.
- **Límite.** 4 MB.

## Relacionado

- [JSON, ARB y JSON Lines](/docs/formats/json) y [Java, INI, Fluent y PHP](/docs/formats/java-ini-fluent-php) para otros formatos de configuración y archivos de idioma.
- [Markdown](/docs/formats/markdown) para el contenido junto a la configuración.
- [Todos los formatos de archivo](/docs/formats)