¿Qué es Markdown?

Markdown es un lenguaje de marcado ligero creado por John Gruber en 2004 que permite escribir texto formateado usando sintaxis de texto plano. Fue diseñado para ser legible incluso en su forma cruda: asteriscos para énfasis, almohadillas para encabezados, guiones para listas. Markdown se usa ampliamente en documentación (READMEs de GitHub), apps de notas (Obsidian, Notion), plataformas de blog y comunicación entre desarrolladores.

Esta herramienta proporciona una vista previa en vivo de tu Markdown mientras escribes. El panel izquierdo muestra el código fuente Markdown y el derecho renderiza la salida formateada en tiempo real. Soporta Markdown estándar, extensiones de GitHub-Flavored Markdown (GFM) (tablas, listas de tareas, tachado, bloques de código vallados) y resaltado de sintaxis para bloques de código.

Sintaxis básica de Markdown

• Encabezados: usa # para H1, ## para H2, ### para H3, y así hasta ###### para H6.
• Negrita: rodea el texto con dobles asteriscos o dobles guiones bajos. Cursiva: usa asteriscos o guiones bajos simples.
• Listas: empieza las líneas con - o * para viñetas, o 1. para listas numeradas. Anida con indentación.
• Enlaces: [texto del enlace](URL). Imágenes: .
• Código: usa comillas invertidas para código inline, triples para bloques vallados con lenguaje opcional para resaltado.

Cómo usar esta herramienta

Escribe o pega Markdown en el editor. La vista previa se actualiza en tiempo real. Puedes alternar entre modo lado a lado y solo vista previa. La herramienta soporta copia al portapapeles (tanto el código fuente Markdown como el HTML renderizado), descarga como archivo .md y exportación como HTML.

GitHub Flavored Markdown

GitHub Flavored Markdown amplía el Markdown estándar con tablas (columnas separadas por barras), listas de tareas (casillas con - [ ] y - [x]), texto tachado (envuelto en dobles tildes), URLs autoenlazadas y bloques de código vallados con resaltado de sintaxis. Esta herramienta soporta todas las funciones GFM, lo que la hace ideal para previsualizar archivos README y documentación antes de subir a GitHub.

Ejemplo práctico

Escribe ## Setup en su propia línea y la vista previa muestra un encabezado de nivel 2. Rodea una frase con dobles asteriscos — **guarda a menudo** — para negrita, y empieza las líneas con un guion y un espacio para crear una lista con viñetas. Un bloque abierto con tres comillas invertidas y la palabra js produce código resaltado. Como Markdown es texto plano, el mismo archivo sigue siendo legible en cualquier editor y se convierte limpiamente a HTML para la web.

Errores comunes

El fallo más común es olvidar la línea en blanco entre un párrafo y una lista o un encabezado: sin ella, muchos analizadores los fusionan en un solo bloque. Las listas anidadas necesitan una sangría uniforme de dos o cuatro espacios, no tabulaciones mezcladas con espacios. Y aunque la mayoría de Markdown permite HTML sin procesar, los signos de menor y mayor que pretenden ser texto literal, como una etiqueta div, deben escaparse o encerrarse en comillas invertidas o desaparecerán del resultado.

Preguntas frecuentes

¿Puedo usar HTML dentro de Markdown?

Sí. El Markdown estándar permite HTML inline para todo lo que la sintaxis Markdown no pueda expresar (como tablas complejas, texto coloreado o vídeos incrustados). Sin embargo, algunos renderizadores de Markdown (como GitHub) eliminan ciertas etiquetas HTML por seguridad. Esta herramienta de previsualización renderiza la mayoría de las etiquetas HTML para mostrarte la salida esperada.

¿Cuál es la diferencia entre Markdown y texto enriquecido?

El texto enriquecido (como los documentos Word) almacena el formato como códigos ocultos dentro del archivo. Markdown almacena el formato como caracteres de texto visibles: **negrita** se escribe literalmente con asteriscos. Esto hace los archivos Markdown portátiles (cualquier editor de texto puede leerlos), amigables con control de versiones (los diffs son limpios) y a prueba de futuro (sin formato propietario).

¿Markdown es igual en todas partes?

La sintaxis básica está estandarizada por CommonMark, pero las variantes difieren. GitHub Flavored Markdown añade tablas, listas de tareas y tachado; otras plataformas admiten notas al pie o fórmulas matemáticas. Cuando importa la portabilidad, cíñete a lo básico de CommonMark y prueba en tu renderizador de destino.