Markdown: guía rápida con vista previa
La sintaxis esencial en una sola tabla, la diferencia entre Markdown clásico y GFM que cambia los saltos de línea y una vista previa para comprobar cada ejemplo.
Markdown es una forma de escribir texto con formato usando símbolos simples: # para un título, ** para negrita, - para una lista. Con la vista previa de Markdown escribes a la izquierda y ves el resultado a la derecha al instante, en tu navegador y sin subir tu texto. Es el formato de los README de GitHub, de muchas plataformas de blogs y de los chats de IA, y aprenderlo toma unos minutos.
La sintaxis esencial
| Quieres | Escribes | Resultado |
|---|---|---|
| Título | # Título | Encabezado de nivel 1 (más #, más pequeño) |
| Negrita | **texto** | texto |
| Cursiva | *texto* | texto en cursiva |
| Tachado | ~~texto~~ | texto tachado (GFM) |
| Lista | - elemento | Viñeta |
| Lista numerada | 1. elemento | Número |
| Tarea | - [x] hecho y - [ ] pendiente | Casilla marcada o vacía (GFM) |
| Enlace | [texto](https://ejemplo.com) | Enlace |
| Imagen |  | Imagen |
| Cita | > texto | Bloque de cita |
| Código en línea | el texto entre comillas inversas | Fuente monoespaciada |
| Bloque de código | tres comillas inversas, el lenguaje y tres más | Bloque con resaltado |
| Tabla | barras verticales y una fila de guiones bajo el encabezado | Tabla (GFM) |
Para separar párrafos, deja una línea en blanco entre ellos.
Markdown estándar y GFM
GFM (GitHub Flavored Markdown) añade a Markdown clásico las tablas, las listas de tareas y el tachado. La herramienta tiene una casilla GFM, activada por defecto. Esto es lo que produce para un ejemplo con tarea y tabla, según el analizador que usa:
- [x] Hecho
- [ ] Pendientegenera una lista con casillas de verificación, una marcada y otra no, y
| a | b |
|---|---|
| 1 | 2 |genera una tabla HTML con su encabezado y su fila. Sin GFM, esas dos construcciones se muestran como texto plano.
El salto de línea que cambia con GFM
En Markdown clásico, un salto de línea simple dentro de un párrafo se ignora: "Línea 1" y "Línea 2" en dos líneas seguidas se unen en un solo párrafo. Con la casilla GFM activada, la herramienta trata ese salto como un salto visible. Si tu texto se ve distinto en otra plataforma, esta diferencia es la primera sospechosa. Para un salto seguro en cualquier lugar, deja una línea en blanco y haz un párrafo nuevo.
Cómo usar la vista previa paso a paso
- Abre la vista previa de Markdown y escribe o pega tu texto en el panel izquierdo. Puedes empezar con una plantilla, como la de README o la de entrada de blog.
- Mira el panel derecho: el resultado se actualiza mientras escribes, con el desplazamiento sincronizado.
- Activa o desactiva GFM y la opción de permitir HTML, según lo que necesites.
- Revisa las estadísticas: palabras, caracteres, minutos de lectura, imágenes y bloques de código.
- Descarga el
.md, exporta a HTML o imprime a PDF.
El resultado pasa por un saneado antes de mostrarse, para que un HTML malicioso pegado en el texto no se ejecute en tu navegador. Los bloques de código se resaltan por lenguaje.
Un documento de ejemplo
Este fragmento muestra varias construcciones a la vez:
# Mi proyecto
Texto con **negrita** y un [enlace](https://ejemplo.com).
## Pasos
1. Instala las dependencias.
2. Ejecuta el programa.
> Nota: revisa los requisitos antes.Pégalo en la vista previa y verás un título, un párrafo con negrita y enlace, un subtítulo, una lista numerada y una cita. Cambiar un símbolo y ver el efecto es la forma más rápida de aprender.
Errores comunes
- Olvidar la línea en blanco antes de una lista o una tabla: sin ella, algunos analizadores las pegan al párrafo anterior.
- Escribir
1)en lugar de1.en listas numeradas, que no todos los analizadores reconocen. - No escapar un símbolo que Markdown interpreta. Para mostrar un asterisco literal, escríbelo como
\*. - Tablas mal alineadas. No hace falta alinear las columnas con espacios, pero sí separar el encabezado con
---en cada columna.
¿Para qué sirve en la práctica?
Para escribir documentación y README, notas, entradas de blog y borradores que luego conviertes a HTML. Y para la IA: los modelos de lenguaje producen y entienden Markdown, por eso conviene pasar los PDF a este formato, como cuenta por qué los PDFs se pegan mal en un chat de IA. Si tu texto va a ir en HTML y necesitas dar formato al resultado, usa el formateador de HTML.
Preguntas frecuentes
¿Qué es Markdown?
Una forma de escribir texto con formato mediante símbolos simples, que se convierte a HTML. Se usa en README, blogs, documentación y chats de IA.
¿Cómo hago una tabla en Markdown?
Con barras verticales y una fila de guiones debajo del encabezado: la primera línea tiene los títulos, la segunda separa el encabezado con guiones, y después va una fila por línea. Las tablas son parte de GFM.
¿Qué diferencia hay entre Markdown y GFM?
GFM añade tablas, listas de tareas y texto tachado. En la herramienta también activa que un salto de línea simple se muestre como salto.
¿Puedo ver cómo quedará antes de publicar?
Sí. La vista previa se actualiza mientras escribes, y puedes exportar a HTML o imprimir a PDF.
¿Es seguro pegar HTML en la vista previa?
El resultado se sanea antes de mostrarse, para que el HTML malicioso no se ejecute. Existe una opción para permitir HTML y conviene usarla solo con texto de confianza.
Escribe Markdown con vista previa
Vista en vivo, bloques de código resaltados, exportar a HTML o imprimir a PDF. 100% local, gratis y sin registro.
Abrir Vista previa de Markdown →Herramientas relacionadas
- Vista previa de Markdown: edita y mira el resultado, exporta a HTML o PDF.
- PDF a Markdown: convierte un PDF en Markdown para un chat de IA.
- Formateador HTML: da formato al HTML exportado.
- Contador de palabras: mide tu texto.
También te puede interesar: mejores herramientas para developers 2026, 10 utilidades de texto que usarás cada semana, Qué es Lorem Ipsum y de dónde viene y Formatear SQL, HTML y código minificado.