Markdown es el lenguaje de marcado que usan GitHub, Notion, Obsidian, Reddit, Discord y media internet técnica. Te permite dar formato a un texto (negritas, listas, enlaces, código) escribiendo símbolos sencillos, sin tocar HTML. Esta guía cubre toda la sintaxis con ejemplos.
Qué es Markdown y por qué se usa
Markdown es una forma de escribir texto con formato usando caracteres normales. La idea: que el texto sea legible tal cual, antes de "renderizarse". **negrita** se entiende incluso sin convertir. Por eso domina la documentación, los README y las notas.
Su ventaja sobre un editor visual: es rápido, portable (texto plano), funciona en cualquier editor y se versiona bien con Git.
Encabezados
Usa almohadillas #. Cuantas más, menor el nivel:
# Título 1
## Título 2
### Título 3
Énfasis: negrita y cursiva
*cursiva* o _cursiva_
**negrita** o __negrita__
***negrita y cursiva***
~~tachado~~
Listas
- Elemento (con guion)
- Otro elemento
- Anidado (dos espacios)
1. Primero
2. Segundo
Enlaces e imágenes
[texto del enlace](https://ejemplo.com)
La diferencia: la imagen lleva ! delante. El "texto alternativo" de la imagen es importante para accesibilidad y SEO.
Código
Para código en línea, comillas invertidas: `código`. Para bloques, tres comillas invertidas y opcionalmente el lenguaje:
```javascript
const saludo = "hola";
```
Tablas (GitHub Flavored Markdown)
| Nombre | Edad |
|--------|------|
| Ana | 30 |
| Luis | 25 |
Los dos puntos en la fila separadora controlan la alineación: :--- izquierda, :---: centro, ---: derecha.
Citas, líneas y tareas
> Esto es una cita
--- (línea horizontal)
- [x] Tarea hecha
- [ ] Tarea pendiente
Markdown vs HTML
Markdown se convierte a HTML para mostrarse en la web. ## Título se transforma en <h2>Título</h2>. Markdown no reemplaza a HTML: lo simplifica para el 90% de los casos de texto con formato. De hecho, en la mayoría de variantes puedes mezclar HTML dentro del Markdown cuando necesitas algo que Markdown no cubre.
Cómo convertir Markdown a HTML o PDF
- Escribe o pega tu Markdown.
- Ve la vista previa renderizada en tiempo real.
- Exporta a HTML, PDF o copia el resultado.
Puedes hacerlo gratis con el conversor de Markdown de esta web, que renderiza y convierte todo en tu navegador.
Preguntas frecuentes
¿Hay un único Markdown? No exactamente. El estándar base es CommonMark, y GitHub Flavored Markdown (GFM) añade tablas, tachado y listas de tareas. Son las variantes más comunes.
¿Puedo usar HTML dentro de Markdown? Sí, en la mayoría de procesadores. Útil para cosas que Markdown no soporta.
¿Cómo hago un salto de línea? Deja una línea en blanco entre párrafos, o termina una línea con dos espacios para un salto simple.
¿Se suben mis datos al convertir? No, si usas un conversor local. Todo ocurre en tu navegador.
Escribe, previsualiza y convierte Markdown a HTML o PDF con el conversor de Markdown gratis, 100% en tu navegador.