Guía completa de Markdown

Markdown es un lenguaje de marcado ligero para dar formato a documentos de texto plano. Lo creó John Gruber en 2004 y hoy está en todas partes: READMEs, documentación, notas y blogs como este, que está escrito entero en Markdown.

Aquí tienes una referencia de la sintaxis para consultar cuando la necesites.

Sintaxis básica

Encabezados

# H1
## H2
### H3
#### H4
##### H5
###### H6

Énfasis

*Texto en cursiva* o _Texto en cursiva_
**Texto en negrita** o __Texto en negrita__
***Texto en negrita y cursiva*** o ___Texto en negrita y cursiva___
~~Texto tachado~~

Listas

Listas sin orden

- Primer elemento
- Segundo elemento
- Tercer elemento
  - Elemento indentado
  - Otro elemento indentado

Listas ordenadas

1. Primer elemento
2. Segundo elemento
3. Tercer elemento
   1. Elemento indentado
   2. Otro elemento indentado

Enlaces e imágenes

[Texto del enlace](https://www.ejemplo.com)
![Texto alternativo](imagen.jpg)

Código

Código en línea

Usa `código` en tu texto

Bloques de código

```javascript
const hola = "mundo";
console.log(hola);
```

Citas

> Esta es una cita
> 
> Puede abarcar múltiples líneas

Líneas horizontales

---
***
___

Sintaxis extendida

Esto no forma parte del Markdown original, y no todos los editores lo soportan. Las tablas, las listas de tareas y las notas al pie funcionan casi en todas partes (GitHub, la mayoría de generadores de sitios); los emojis por código y el resaltado con == dependen mucho de la herramienta.

Tablas

| Sintaxis | Descripción |
| ----------- | ----------- |
| Encabezado | Título |
| Párrafo | Texto |

Listas de tareas

- [x] Escribir el comunicado de prensa
- [ ] Actualizar el sitio web
- [ ] Contactar a los medios

Notas al pie

Aquí hay una oración con una nota al pie. [^1]

[^1]: Esta es la nota al pie.

Emojis

:smile: :heart: :rocket:

Resaltado

==texto resaltado==

Buenas prácticas

1. Mantenlo simple: Markdown está pensado para leerse bien incluso sin renderizar.
2. Sé consistente: si usas - para las listas, úsalo siempre; lo mismo con * o _ para el énfasis.
3. Deja líneas en blanco entre bloques. Muchos problemas de formato vienen de pegar un párrafo a una lista o a un encabezado.
4. Respeta el orden de los encabezados: un solo H1 y niveles inferiores para las subsecciones, sin saltarte niveles.
5. Escapa los caracteres especiales con la barra invertida (\*) cuando quieras que se vean tal cual.

Errores comunes

• Olvidar el espacio después del # en los encabezados
• No indentar correctamente las listas anidadas
• Mezclar diferentes marcadores de lista
• No escapar caracteres especiales cuando es necesario

Herramientas y recursos

• Guía de Markdown
• Hoja de Referencia de Markdown
• Dillinger: editor de Markdown en línea.
• Markdown Live Preview: vista previa en vivo.

La mejor forma de aprenderlo es usarlo: en unos pocos documentos ya no vas a necesitar consultar esta guía más que para la sintaxis extendida.