Traducir Markdown es fácil hasta que tienes doscientas páginas. Entonces, las palabras no son el problema: lo es todo lo que las rodea. El código que no debe cambiar, los enlaces que deben seguir funcionando y la próxima versión, que añadirá diez páginas más.
Esta guía está pensada para sitios de documentación, archivos README, registros de cambios y carpetas de blogs escritos en Markdown o MDX.
¿Qué opción deberías usar?
| Ideal para | Limitaciones | |
|---|---|---|
| AI Glot | Una carpeta de documentación, varios idiomas, un glosario que debe respetarse y cada nueva versión | No hace falta para un párrafo breve de un README |
| Una plataforma de gestión de traducciones (Crowdin, Lokalise, Phrase) | Un equipo con un flujo de trabajo continuo, revisores y conexión a un repositorio | Antes de traducir la primera página, tienes que crear un proyecto y conectar el repositorio |
| DeepL | Los documentos que admite: Word, PowerPoint, Excel, PDF, HTML, texto y otros | Markdown no figura en la lista, así que primero tienes que pegar el texto o convertir el archivo |
| ChatGPT, Claude u otro asistente | Una página breve | Pegas cada página y tienes que incluir el glosario en cada chat. Debes comprobar que no se haya modificado el código ni los enlaces, y una carpeta de documentación extensa consume tu cuota de uso |
| Un profesional autónomo o una agencia | La página de destino y la página de precios | El proceso es lento, se cobra por palabra y sigues teniendo que preparar los archivos |
Pide a una persona que lea la página que vende el producto. Traduce la documentación de referencia con un motor, porque ahí es donde está el volumen.
Por qué AI Glot encaja en una carpeta de documentación
- El contenido entra y la estructura no estorba. Los encabezados, párrafos, elementos de lista y celdas de tabla son texto. El código, los destinos de los enlaces, los bloques HTML y los separadores de las tablas se mantienen tal cual.
- El formato sigue a las palabras. La negrita, la cursiva y el texto de los enlaces se mantienen junto a las palabras a las que corresponden.
- Un único glosario para todo el sitio de documentación. Los nombres de tus productos y los términos de la API se traducen igual en todas las páginas y en las versiones futuras.
- Un plan antes de empezar a gastar. Indica qué ha encontrado y qué va a traducir.
- Una carpeta, un solo proceso. Comprime los archivos en un ZIP y se reconstruirá la estructura.
El recorrido de un archivo
- 1SubirUn archivo .md o .mdx, o un ZIPHasta 4 MB cada uno
- 2Dinos qué necesitasUna frase sencillaGratis
- 3Leer el planQué ha encontrado, idiomas y costeGratis
- 4AprobarEl único paso que genera gastoConsume créditos
- 5DescargarMarkdown traducidoSuéltalo aquí
Qué cambia en una página
Solo cambia el texto. El código, el enlace y las claves del front matter no cambian.
---title: Install the CLItitle: Installer la CLIslug: install---Run `npm install -g tool` and read the [guide](/es/docs/setup).Lancez `npm install -g tool` et lisez le [guide](/es/docs/setup).Qué revisar en MDX
Las importaciones, las etiquetas de componentes y las expresiones se dejan intactas. Así la página se sigue compilando. El detalle está en el texto que pasas a un componente como prop, por ejemplo, un título que se pasa a una tarjeta. Ese texto pertenece al componente, no al texto de la página, así que revisa después esas pocas cadenas.
Anclas de encabezado. Si tu sitio crea un ancla a partir del texto del encabezado, al traducirlo se genera una nueva. Conviene revisar los enlaces que apuntan a un encabezado, como el de la sección de instalación.
Cómo hacerlo, paso a paso
1. Prueba un archivo gratis. El traductor de Markdown no requiere cuenta y admite archivos de hasta 2 MB y 5,000 palabras.
2. Sube el archivo o un ZIP de la carpeta en la aplicación.
3. Explica lo que necesitas en una frase.
Translate this folder into French.
Translate the prose and the front matter title and description.
Leave every other front matter field as it is.La frase determina qué se traduce en toda la carpeta. Una regla de redacción, como “mantener los nombres de productos y los términos de API en inglés”, va en el segundo cuadro al aprobar, porque se aplica a cada párrafo a medida que se traduce.
4. Añade un glosario con nombres de productos, términos de API y las palabras que siempre usas de la misma manera. Cómo crear uno.
5. Lee el plan y elige un nivel de calidad.
Lite ofrece aproximadamente tres veces más palabras por crédito y es más rápido: ideal para actualizar en bloque la documentación de referencia. Standard es para la página de destino. Un crédito equivale a una palabra en Standard.
6. Aprueba y descarga.
Una carpeta de documentación, varios idiomas
Las cifras son un ejemplo. Un archivo Markdown contiene un solo idioma, así que cada idioma tiene su propia copia traducida de la carpeta.
Tres formas de usarlo
Desde la línea de comandos es lo más adecuado para un repositorio de documentación, porque los mismos cuatro pasos se ejecutan en un script o en CI cada vez que cambia el inglés:
id=$(aiglot batches create docs.zip \
--instruction "Translate into French. Translate the prose and the front matter title and description." \
--json | jq -r '.data.id')
aiglot batches get "$id" --json | jq '.data.plan'
aiglot batches approve "$id" --quality lite \
--instructions "Keep product names and API terms in English."
aiglot batches download "$id" --output docs_fr.zipCon tu agente de IA: conecta AI Glot como servidor MCP. El agente puede leer tu repositorio, proponer los términos del glosario que encuentre, ejecutar el proceso y volver a colocar los archivos en su sitio.
En la aplicación: sube el archivo, haz clic y descárgalo. Ideal para una sola página.
Si quieres integrar la API, consulta la documentación de la API.
Comprueba el resultado
Genera el sitio de documentación en un idioma traducido y abre tres páginas: una con código, otra con una tabla y otra con un enlace a otra página. Ejecuta el comprobador de enlaces habitual, porque es ahí donde se detecta un cambio en un ancla. Conserva los archivos en inglés hasta que alguien que conozca el idioma haya revisado las páginas importantes.
En Precios encontrarás el coste de un volumen mayor, y con una cuenta gratuita obtienes créditos para procesar una carpeta real.
Los límites que se indican aquí son los vigentes cuando se redactó este texto: 4 MB por archivo Markdown, 200 archivos y 20 MB por ZIP, y 2 MB y 5,000 palabras en la herramienta gratuita. La lista de DeepL procede de su propia documentación. Los nombres de archivo y el número de páginas de los diagramas son ejemplos. En tu plan aparecen las cifras reales de tus archivos, y consultarlo es gratis.