Traducir documentos Markdown y MDX
Un documento no es una lista de claves. Su texto está disperso en bloques de código, enlaces y front matter que deben conservarse exactamente. KAERIS divide el archivo en piezas protegidas y prosa, traduce solo la prosa y vuelve a ensamblar las piezas.
KAERIS ha traducido esta página y revisado cada línea traduciéndola de vuelta. Un hablante nativo aún no la ha revisado. Original en inglés
Cómo se lee un documento Markdown
El documento se divide en un esqueleto de piezas literales y segmentos de texto numerados. Dentro de un segmento, el código en línea, destinos de enlaces, etiquetas HTML y JSX se sustituyen por tokens como {0} antes de la traducción y se restauran después. Un modelo que omite uno activa el mismo detector que una variable omitida.
--- title: Getting started slug: getting-started --- # Getting started Install the package with `pip install kaeris`, then read the [CLI guide](/docs/cli). ```bash kaeris translate en.json --langs de,ja ``` Run it once per release. It only translates new keys.
Qué tener en cuenta en las traducciones Markdown
El código no es prosa
Un bloque de código traducido sigue renderizándose, pero falla para quien lo copia. Los bloques de código con cercos o indentados, código en línea y líneas MDX
import/exportnunca se traducen.Enlaces
El texto del enlace se traduce; el destino no. Una URL traducida sigue pareciendo un enlace y luego devuelve 404.
Front matter
Configuraciones como
slug,date,layoutytagspermanecen sin cambios. Campos visibles para el lector, comotitleysummary, se traducen.Un límite conocido
El texto dentro de un componente JSX multilínea se conserva entero, no se traduce. El lector de esta página se informa aquí, no después de la compilación.
Una ejecución real, antes y después
Una ejecución real: nuestro documento de prueba, alemán, 26 de octubre de 2026, reducido al inicio y un bloque de código. El encabezado, texto en negrita, el comando curl y el token $TOKEN están como en la fuente; solo cambiaron la prosa y los campos front matter visibles para el lector.
---
title: Returns and refunds
summary: How to return a record, and when you will not get a refund.
---
# Returns and refunds
You can return an unopened record within **30 days** of delivery. We refund the full price, but not the shipping cost.
…
```bash
curl https://api.example.com/v1/returns/RT-1042 -H "Authorization: Bearer $TOKEN"
```
---
title: Rücksendungen und Erstattungen
summary: So senden Sie eine Schallplatte zurück und wann Sie keine Erstattung erhalten.
---
# Rücksendungen und Erstattungen
Sie können eine ungeöffnete Schallplatte innerhalb von **30 Tagen** nach Lieferung zurücksenden. Wir erstatten den vollen Preis, jedoch nicht die Versandkosten.
…
```bash
curl https://api.example.com/v1/returns/RT-1042 -H "Authorization: Bearer $TOKEN"
```
Lo que KAERIS hace con él
Esqueleto y prosa separados
Encabezados, tablas, listas y cercos mantienen su forma; solo se intercambia la prosa interna.
Una salida por idioma
guide.mdse convierte ende.md,ja.mdy así sucesivamente.Cada línea traducida de vuelta
--verifytraduce el resultado de nuevo y escribeverify.jsonpara que puedas leer lo que ahora dice cada parte.
Ejecuta en tres pasos
Instala el CLI
Ejecuta
pip install kaeris.Traduce el documento
Ejecuta
kaeris translate docs/guide.md --langs de,ja. Un patrón comodocs/*.mdtraduce varios archivos.Léelo de vuelta
Abre
verify.jsonde la ejecución con--verifypara ver qué dice ahora cada parte traducida en tu idioma.
pip install kaeris kaeris translate docs/guide.md --langs de,ja --verify
Preguntas
¿Se traduce el código en mis documentos?
No. Los bloques de código delimitados y con sangría, el código en línea, las URLs, las etiquetas HTML y JSX se devuelven byte a byte.
¿Traduce componentes MDX?
La prosa y las partes de una sola línea alrededor sí. El texto dentro de un componente JSX multilínea se conserva en lugar de traducirse, lo cual es una limitación del lector de formato.
¿Es gratis?
Sí, sin cuenta: 10.000 caracteres por archivo y hasta 8 idiomas por ejecución. Una clave API gratuita eleva el límite de archivos a 50.000 caracteres. La licencia vitalicia cuesta $79 una vez, con tu propia clave OpenRouter; los planes mensuales empiezan en $19. Precios
¿Puedo ejecutarlo desde la terminal o en CI?
Sí. pip install kaeris, luego kaeris translate docs/guide.md --langs de,ja. El GitHub Action ejecuta la misma traducción en un pull request. Documentación CLI · GitHub Action
Seguir adelante
Referencia CLI · Referencia de verificación · Traducir en el navegador · Verificación gratuita · Convertir formatos · Pseudo-localización
Otros formatos: JSON · YAML · .po · ARB · XLIFF · .strings · .xcstrings · .properties · .resx · CSV · Fluent · Android XML