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/)
![Texto alternativo](imagenes/foto.png)

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:

Chuleta de Markdown

Resultado Sintaxis
Encabezado # Encabezado
Negrita **texto**
Cursiva *texto*
Tachado ~~texto~~
Enlace [texto](url)
Imagen ![alt](ruta)
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.