Cómo traducir archivos Markdown

Traducir archivos Markdown es rápido y fácil con nuestra herramienta impulsada por IA. Siga estos pasos para obtener traducciones precisas y que preservan el formato para su documentación, archivos README y contenido de sitios estáticos.

1. Pegue su contenido de Markdown: Copie y pegue el contenido de su archivo .md en el área de texto de arriba. Soporta Markdown estándar, GitHub Flavored Markdown (GFM) y Markdown con front matter YAML.
2. Establezca el idioma de destino: Ingrese el código de idioma ISO al que desea traducir (por ejemplo, fr para francés, de para alemán, ja para japonés).
3. Haga clic en Traducir: Nuestra IA traducirá el contenido de texto mientras preserva todo el formato Markdown: encabezados, negrita/cursiva, listas, bloques de código, enlaces, imágenes y front matter.
4. Copie o guarde el resultado: Una vez completada la traducción, copie el Markdown traducido al portapapeles o guárdelo directamente como un archivo .md.

¿Qué es Markdown y por qué traducirlo?

Markdown es un lenguaje de marcado ligero que convierte texto plano en HTML formateado. Creado por John Gruber en 2004, se ha convertido en el formato estándar para documentación, archivos README, wikis y sistemas de gestión de contenido en todo el mundo. Su sintaxis simple y legible lo hace ideal para redactores técnicos, desarrolladores y creadores de contenido.

A medida que los productos de software y la documentación llegan a audiencias globales, traducir el contenido de Markdown se vuelve esencial. Localizar sus archivos README, guías de usuario, documentación de API y publicaciones de blog asegura que los usuarios de diferentes idiomas puedan entender y utilizar completamente su producto. La documentación mal localizada o no traducida es una de las mayores barreras para la adopción internacional.

Traducir Markdown manualmente es propenso a errores: es fácil romper accidentalmente la sintaxis de formato, corromper bloques de código o dañar estructuras de enlaces. Nuestra traducción de Markdown impulsada por IA preserva todos los elementos de sintaxis mientras traduce con precisión solo el contenido de texto legible por humanos.

Sintaxis y estructura de Markdown

Un documento Markdown típico contiene una mezcla de elementos de texto formateados. Nuestro motor de traducción entiende y preserva todos ellos:

# Getting Started

Welcome to **My Application**! This guide will help you get up and running quickly.

## Installation

Run the following command to install:

```bash
npm install my-application
```

## Features

- Fast and lightweight
- Easy to configure
- Supports multiple languages

> **Note:** Make sure you have Node.js 18 or higher installed.

For more information, see the [documentation](https://example.com/docs).

• Encabezados (#, ##, ###): Los títulos de sección se traducen mientras que los marcadores de nivel de encabezado se preservan exactamente como están.
• Negrita y cursiva (**texto**, *texto*): Los marcadores de énfasis en línea se mantienen intactos alrededor del texto traducido.
• Listas ordenadas y desordenadas (-, *, 1.): La estructura y el anidamiento de las listas se preservan; solo se traduce el texto del elemento de la lista.
• Bloques de código (```) y código en línea (`): Todo el contenido del código se preserva intacto. La IA nunca traduce código, comandos o identificadores técnicos.
• Enlaces ([texto](url)) e imágenes (![alt](src)): Las URL y las rutas de imagen permanecen sin cambios. Solo se traducen el texto del enlace y el texto alternativo de la imagen.
• Citas en bloque (>): Los marcadores de cita en bloque se preservan; el contenido del texto citado se traduce.

Soporte de front matter YAML

Muchos archivos Markdown utilizados en generadores de sitios estáticos (Jekyll, Hugo, Docusaurus, Gatsby) incluyen front matter YAML: metadatos en la parte superior del archivo delimitados por ---. Nuestra IA maneja inteligentemente el front matter:

---
title: "User Guide"
description: "Complete guide for using our application"
lang: en
sidebar_label: "User Guide"
---

# User Guide

This page explains how to use the core features of our application.

## Quick Start

1. Open the application
2. Sign in with your account
3. Select your preferred language from the settings

## Support

If you need help, please visit our [support page](https://example.com/support)
or contact us at support@example.com.

Los valores traducibles como <code>title</code>, <code>description</code> y <code>sidebar_label</code> se traducen, mientras que las claves técnicas como <code>date</code>, <code>slug</code>, <code>lang</code>, <code>draft</code> y <code>weight</code> se dejan sin cambios. Esto asegura que sus archivos Markdown traducidos sean inmediatamente compatibles con su generador de sitios estáticos o CMS.

Markdown en la localización de software

Markdown se ha convertido en un ciudadano de primera clase en la localización de software. A medida que se extienden las prácticas de documentación como código, los equipos almacenan la documentación en repositorios Git junto con el código fuente, y Markdown es el formato preferido. Localizar esta documentación requiere el mismo rigor que localizar cadenas de interfaz de usuario.

Las plataformas de localización modernas soportan cada vez más Markdown junto con formatos tradicionales como XLIFF, PO y JSON. Ya sea que esté localizando un repositorio de GitHub, un sitio web de documentación o una base de conocimientos, la traducción de Markdown es ahora una parte central del flujo de trabajo de internacionalización.

Localización de Markdown para generadores de sitios estáticos

Los generadores de sitios estáticos dependen de archivos Markdown con front matter para contenido multilingüe. Cada idioma generalmente tiene su propio directorio de archivos Markdown traducidos:

• Jekyll: Utiliza directorios _posts y de contenido con carpetas por idioma o front matter específico del idioma. Los plugins jekyll-multiple-languages-plugin y jekyll-polyglot de Jekyll gestionan páginas Markdown multilingües.
• Hugo: Soporta la traducción de contenido a través de directorios específicos del idioma (content/en/, content/fr/) o añadiendo códigos de idioma a los nombres de archivo (about.fr.md). El modo multilingüe integrado de Hugo es ampliamente utilizado para sitios de documentación y marketing.
• Docusaurus: Docusaurus de Facebook utiliza una carpeta dedicada i18n/ para páginas Markdown traducidas, con la misma estructura de archivos reflejada para cada idioma. Traducir archivos Markdown de Docusaurus es uno de los casos de uso más comunes para la localización de Markdown.
• Gatsby: Los sitios de Gatsby utilizan plugins como gatsby-plugin-i18n y almacenan el contenido traducido como archivos Markdown separados por idioma, a menudo con front matter especificando el idioma y el slug.
• VitePress: El marco de documentación VitePress de Vue utiliza subdirectorios específicos por idioma para archivos Markdown traducidos, lo que facilita el mantenimiento de documentación técnica multilingüe.

Traducción de README y documentación técnica

Los archivos README y la documentación técnica se encuentran entre los contenidos con mayor impacto para localizar en proyectos de código abierto y herramientas para desarrolladores:

• Archivos README.md: Lo primero que ven los usuarios en GitHub, npm o PyPI. Un README traducido aumenta significativamente la adopción en mercados que no son de habla inglesa. Traducir su README al chino, japonés, coreano, español o portugués puede ampliar drásticamente el alcance de su proyecto.
• GitHub Wiki: Las wikis de GitHub utilizan Markdown y se localizan cada vez más para proyectos grandes de código abierto. Las páginas wiki traducidas ayudan a los colaboradores y usuarios de diferentes regiones a comprender la documentación del proyecto.
• CHANGELOG.md y notas de la versión: Traducir los registros de cambios y las notas de la versión ayuda a los usuarios internacionales a comprender qué cambió entre versiones y cómo les afecta.
• Documentación de API: La documentación de referencia de la API escrita en Markdown (utilizando herramientas como Slate, Redoc o Swagger UI) se beneficia de la traducción para ayudar a los desarrolladores de diferentes regiones a integrar su API de manera más efectiva.

Generación de glosario con IA para traducciones de Markdown

Nuestra función de generación de glosario con IA le ayuda a mantener una terminología consistente en toda su documentación Markdown. Habilítela activando Generar glosario en las opciones de traducción:

• Terminología consistente: la IA analiza su contenido Markdown de origen y las traducciones de destino existentes para crear un glosario de términos clave, asegurando que los nombres de productos, conceptos técnicos y etiquetas de interfaz de usuario se traduzcan de manera consistente en todas sus páginas de documentación.
• Términos específicos del dominio: proporcione una muestra de contenido Markdown ya traducido en el campo de cadenas de destino. La IA aprende su terminología preferida y la aplica automáticamente a las nuevas páginas de documentación.
• Cómo utilizarlo: pegue su contenido Markdown traducido en el campo opcional de cadenas de destino que aparece cuando la generación de glosario está habilitada. La IA extrae pares de términos recurrentes y los utiliza como guía de traducción. Si no se proporciona contenido de destino, la IA genera un glosario solo a partir de la documentación de origen.

¿Por qué utilizar l10n.dev para la traducción de Markdown?

• Traducción contextual con IA: Nuestra IA comprende la estructura de Markdown y traduce el texto con conocimiento del contexto, la terminología clínica y la documentación circundante.
• Preservación completa del formato: Los encabezados, negritas/cursivas, listas, tablas, citas en bloque y toda la sintaxis de Markdown se conservan exactamente. Solo se traduce el texto legible por humanos.
• Soporte para Front Matter: El front matter YAML se maneja de forma inteligente: los metadatos traducibles como títulos y descripciones se traducen; los campos técnicos como slugs, fechas e identificadores se dejan sin cambios.
• Protección de bloques de código: Todos los bloques de código (cercados e indentados), el código en línea y los identificadores técnicos se dejan completamente intactos durante la traducción.
• Preservación de enlaces e imágenes: Todas las URL, rutas de imágenes, anclas y enlaces de referencia permanecen intactos. Solo se traducen el texto del enlace y el texto alternativo de la imagen.
• Rentable: Nuestro servicio es más asequible que otras soluciones de traducción automática. Los usuarios reciben 10,000 caracteres gratis al mes.Ver precios
• Optimizado para documentos largos: Procesa de manera eficiente archivos Markdown extensos (entradas de blog, páginas de documentación completas y guías de varias secciones), manteniendo la consistencia de traducción en todo momento.

Casos de uso comunes para la traducción de Markdown

La traducción de Markdown se utiliza en una amplia gama de escenarios de documentación y localización de contenido:

• Localización de README.md: Traduzca sus archivos README de GitHub, GitLab o Bitbucket para ayudar a los desarrolladores internacionales a comprender su proyecto, los pasos de instalación y los ejemplos de uso.
• Sitios web de documentación: Traduzca sitios de documentación de Docusaurus, VitePress, MkDocs o GitBook para hacer que la documentación técnica sea accesible para los desarrolladores de todo el mundo.
• Contenido de sitios estáticos: Traduzca el contenido de las páginas de Jekyll, Hugo, Gatsby o Astro para ofrecer sitios web multilingües con un SEO adecuado para cada idioma.
• Páginas de GitHub Wiki: Localice wikis de proyectos de código abierto para ayudar a los colaboradores y usuarios de diferentes orígenes lingüísticos a navegar y contribuir a su proyecto.
• Entradas de blog técnico: Traduzca entradas de blog para desarrolladores, tutoriales y guías prácticas escritas en Markdown para llegar a ingenieros y usuarios técnicos a nivel mundial.
• Artículos de base de conocimientos: Traduzca artículos de ayuda, preguntas frecuentes y documentación de soporte almacenados como Markdown en herramientas como la exportación de Notion, Outline o bases de conocimientos personalizadas.
• Notas de la versión y registros de cambios: Traduzca archivos CHANGELOG.md y notas de la versión para que los equipos y usuarios internacionales se mantengan informados sobre las actualizaciones del producto en su idioma.

Markdown frente a otros formatos de localización

Markdown ocupa una posición única en el ecosistema de localización. A diferencia de JSON, YAML o XLIFF (que almacenan cadenas de traducción aisladas), los archivos Markdown contienen documentos de prosa completos con contenido mixto: texto en lenguaje natural, ejemplos de código, sintaxis estructurada y metadatos. Esto hace que la traducción de Markdown sea fundamentalmente diferente de la localización basada en cadenas.

Los flujos de trabajo de localización tradicionales extraen cadenas traducibles a archivos de recursos y las traducen individualmente. La localización de Markdown, en cambio, traduce documentos completos preservando su estructura. Esto requiere una IA que comprenda qué partes del documento deben traducirse (prosa, encabezados, elementos de lista, texto alternativo) y cuáles nunca deben tocarse (bloques de código, URL, claves de front matter).

Nuestra traducción con IA maneja documentos Markdown de forma nativa: no es necesario preprocesar ni extraer cadenas. Pegue su archivo Markdown, seleccione un idioma de destino y reciba un archivo <code>.md</code> totalmente traducido y estructuralmente intacto, listo para confirmar en su repositorio.

Preguntas frecuentes

¿Qué elementos de Markdown se conservan durante la traducción?

Toda la sintaxis de Markdown se conserva: encabezados (#, ##), negritas (**), cursivas (*), listas, tablas, citas en bloque (>), enlaces ([texto](url)), imágenes (![alt](src)) y bloques de código cercados (```). El contenido del código dentro de bloques y comillas invertidas nunca se traduce.

¿Se traduce el front matter YAML?

Sí, de forma selectiva. Nuestra IA traduce campos de front matter legibles por humanos como title, description y sidebar_label. Los campos técnicos como slug, date, lang, draft, weight e id se dejan sin cambios para garantizar la compatibilidad con su generador de sitios estáticos.

¿Cómo traduzco un archivo Markdown?

Pegue el contenido de su archivo .md en el editor de arriba, introduzca el código del idioma de destino (por ejemplo, fr, de, ja, zh) y haga clic en Traducir. La IA devolverá un documento Markdown totalmente traducido preservando todo el formato. Puede copiar el resultado o guardarlo como un archivo .md.

¿Puedo traducir archivos Markdown grandes?

Esta página funciona mejor para archivos Markdown individuales de hasta unos pocos cientos de kilobytes. Para la traducción masiva de Markdown o documentos muy largos, recomendamos utilizar la página de Traducción de archivos i18n, que admite subidas de archivos de hasta 5 MB y proporciona una entrega más fiable para la localización de contenido a gran escala.