El formato Markdown y la necesidad de conversión
Para utilizar la herramienta, puedes escribir o pegar texto Markdown directamente en el editor. La herramienta te permite visualizar una vista previa en vivo de cómo quedará el contenido, así como obtener el código HTML generado.
Si quieres exportar el contenido, puedes descargar un documento de Microsoft Word (.docx) o un archivo HTML independiente. Cada exportación tiene sus propias condiciones — un editor vacío, un texto demasiado largo para la exportación local a Word o una conversión que no llega a completarse — y la herramienta te avisa con un mensaje distinto en cada caso; los tres se detallan más adelante.
Funcionamiento de la herramienta y procesamiento local
Esta utilidad realiza la conversión de texto Markdown a formatos Word y HTML de manera inmediata. El procesamiento de los datos se ejecuta íntegramente en el navegador del usuario. La generación de la vista previa, la exportación a HTML y la creación del documento Word ocurren de forma local, por lo que no se sube nada a BroBroGo.
El flujo de trabajo se divide en las siguientes etapas:
- Entrada de texto: El usuario escribe o pega su contenido en el área de edición, la cual cuenta con el indicador "Escribe tu Markdown".
- Análisis y recuento: El sistema evalúa el texto en tiempo real y actualiza los contadores de "Palabras" y "Caracteres". Si el editor se vacía, el estado cambia a "Editor borrado." y el contador de caracteres se establece en 0.
- Renderizado de vista previa: Se genera una representación visual del documento. Si el área de entrada está vacía, se muestra el texto "Tu vista previa y el HTML aparecerán aquí.".
- Exportación: Puedes descargar el archivo final mediante las opciones "Descargar Word" o "Descargar HTML", o bien utilizar la función "Copiar HTML".
Reglas de conversión y comportamiento del sistema
El conversor aplica reglas específicas para garantizar la integridad del diseño y la seguridad de los archivos resultantes:
- Asignación de nombres: El nombre del archivo Word (.docx) exportado se genera automáticamente a partir del primer encabezado H1 presente en el texto Markdown. Si no se detecta ningún encabezado H1, se utiliza el nombre por defecto "Documento sin título".
- Seguridad en HTML: Cualquier fragmento de HTML sin procesar que se introduzca dentro del texto Markdown se escapa antes de renderizarse en la exportación. Esto evita la ejecución de scripts no deseados.
- Enlaces seguros: Todos los hipervínculos generados en la vista previa y en el código HTML final incorporan los atributos
noopener noreferrerpara proteger la navegación del usuario. - Estructura del archivo HTML: La opción "Descargar HTML" genera un documento HTML independiente, sencillo y limpio, listo para ser visualizado en cualquier navegador o integrado en un servidor web.
Control de errores y límites de exportación
El proceso de conversión local en el navegador está sujeto a límites de memoria técnica para garantizar la estabilidad del sistema. La herramienta gestiona estas restricciones mediante los siguientes avisos:
- Intento de exportación vacío: Si se intenta realizar una descarga sin haber introducido texto, el sistema muestra el mensaje "Aún no hay nada que exportar — escribe algo de Markdown primero.".
- Límite de tamaño para Word: La exportación local a formato.docx requiere que el volumen de texto no supere un límite crítico de caracteres. Si el texto excede este tamaño, aparece la advertencia "Este Markdown es demasiado grande para exportarlo a Word localmente. Manténlo por debajo de
{max}caracteres.". - Fallo general de conversión: En caso de que ocurra una interrupción inesperada durante el proceso, la interfaz mostrará el mensaje "La conversión falló. Prueba con un documento Markdown más pequeño.".
Estructura de equivalencias de formato
El conversor procesa la sintaxis estándar de Markdown y la traduce a sus equivalentes exactos en Word y HTML:
| Elemento Markdown | Resultado en Word (.docx) | Etiqueta HTML resultante |
|---|---|---|
# Encabezado 1 |
Estilo de Título 1 (determina el nombre del archivo) | <h1> |
## Encabezado 2 |
Estilo de Título 2 | <h2> |
**Texto negrita** |
Formato de fuente negrita | <strong> |
*Texto cursiva* |
Formato de fuente cursiva | <em> |
- Elemento de lista |
Lista con viñetas | <ul><li> |
1. Elemento numerado |
Lista numerada secuencial | <ol><li> |
[Enlace](url) |
Hipervínculo activo | <a href="url" rel="noopener noreferrer"> |
| ` | Tabla | ` |
- Tarea |
Lista de tareas con casilla | Lista con casilla de verificación |
Code |
Bloque de código con tipografía monoespaciada | <pre><code> |
Preguntas frecuentes
¿Se sube mi Markdown?
No. La vista previa, la exportación HTML y la generación del documento Word se hacen localmente en tu navegador.
¿Qué conserva la exportación a Word?
El DOCX conserva la estructura común de Markdown: encabezados, listas, tablas, enlaces, bloques de código, énfasis y listas de tareas.
¿La exportación HTML incluye scripts inseguros?
No. El HTML sin procesar dentro de tu Markdown se escapa antes de renderizarse, y la descarga es un documento HTML independiente y sencillo.
¿Cómo se decide el nombre del archivo Word descargado?
El sistema toma el texto del primer encabezado H1 (marcado con un solo #) para nombrar el archivo.docx. Si no existe dicho encabezado, el archivo se descargará con el nombre "Documento sin título".