Sintaxis de Markdown: encabezados, listas, enlaces y tablas explicados
Markdown es una forma de escribir documentos con formato usando solo texto. Basta con añadir algunos símbolos como #, * o -, y un visor de Markdown los convierte en encabezados, negritas y listas. Los README, la documentación técnica, los blogs y apps de notas como Obsidian o Notion usan Markdown: lo aprendes una vez y lo usas en todas partes.
Esta guía reúne la sintaxis que usarás a diario, con un ejemplo para cada caso. Cuando termines, arrastra tu archivo .md al visor de Markdown online Moread para ver el resultado.
Encabezados
Empieza la línea con #. La cantidad de # indica el nivel, de # (el más grande) a ######. Deja un espacio después del último #.
# Título del documento
## Capítulo uno
### Sección 1.1
Lo habitual es un único título con # y usar ## y ### para estructurar. Moread crea automáticamente el índice de la derecha a partir de tus encabezados.
Párrafos y saltos de línea
Las líneas seguidas forman un mismo párrafo. Deja una línea en blanco para empezar otro. Para saltar de línea sin crear un párrafo nuevo, termina la línea con dos espacios.
Negrita, cursiva y tachado
**texto en negrita**
*texto en cursiva*
~~tachado~~
`código en línea`
Listas
Las listas con viñetas empiezan con -, * o +. Las numeradas usan un número y un punto. Sangra con dos a cuatro espacios para anidar elementos.
- Manzanas
- Plátanos
- Plátano macho (anidado)
1. Abre el archivo
2. Elige un tema
3. Empieza a leer
Listas de tareas
GitHub Flavored Markdown (GFM) añade casillas, ideales para listas de pendientes:
- [x] Escribir el esquema
- [ ] Añadir ejemplos
- [ ] Revisar erratas
Enlaces e imágenes
[Moread](https://md-viewer.amemori.win/)

Una imagen es un enlace con un signo de exclamación delante. El texto alternativo aparece si la imagen no carga y ayuda a lectores de pantalla y buscadores. En Moread, usa Abrir carpeta para que se muestren las imágenes de tu documento.
Citas
Empieza una línea con > para citas, notas o ideas clave:
> En el espacio, las palabras respiran.
Bloques de código
Encierra el código entre tres comillas invertidas e indica el lenguaje para obtener resaltado de sintaxis:
```javascript
const total = [1, 2, 3].reduce((a, b) => a + b, 0);
console.log(total);
```
Moread resalta cientos de lenguajes. Los bloques de JavaScript incluso tienen un botón ▷ Ejecutar que corre el código en un sandbox seguro.
Tablas
Separa columnas con | y pon una fila con --- debajo del encabezado. Los dos puntos controlan la alineación.
| Función | Atajo | Nota |
| :--- | :---: | ---: |
| Abrir archivo | Ctrl O | Elige un .md |
| Buscar | Ctrl F | Busca en el documento |
:--- alinea a la izquierda, :---: centra y ---: alinea a la derecha.
Líneas horizontales y caracteres de escape
Tres o más - o * en una línea crean una línea horizontal. Para mostrar un símbolo literal como * o #, ponle una barra invertida delante: \*no es cursiva\*.
Más allá de lo básico: diagramas y fórmulas
El Markdown estándar no tiene diagramas ni ecuaciones, pero dos extensiones populares cubren ese hueco, y Moread admite ambas:
- Diagramas Mermaid: dibuja diagramas de flujo, de secuencia y de Gantt con texto. Consulta la guía de diagramas Mermaid.
- Fórmulas LaTeX: escribe ecuaciones con
$...$y$$...$$. Consulta fórmulas LaTeX en Markdown.
Chuleta de Markdown
| Resultado | Sintaxis |
|---|---|
| Encabezado | # Encabezado |
| Negrita | **texto** |
| Cursiva | *texto* |
| Tachado | ~~texto~~ |
| Enlace | [texto](url) |
| Imagen |  |
| Lista con viñetas | - elemento |
| Lista numerada | 1. elemento |
| Lista de tareas | - [ ] pendiente |
| Cita | > cita |
| Código en línea | `code` |
| Línea horizontal | --- |
¿Terminaste? Arrastra tu archivo a Moread para verlo maquetado o guárdalo como PDF para compartirlo.