La guía completa de Markdown

Markdown es un lenguaje de marcado ligero que puedes usar para añadir formato a documentos de texto plano. Creado por John Gruber en 2004, hoy es uno de los lenguajes de marcado más populares del mundo.

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__
***Negrita y cursiva*** o ___Negrita y cursiva___
~~Texto tachado~~

Listas

Listas sin orden

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

Listas numeradas

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` dentro de tu texto

Bloques de código

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

Citas

> Esto es una cita
> 
> Puede ocupar varias líneas

Líneas horizontales

---
***
___

Sintaxis extendida

Tablas

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

Listas de tareas

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

Notas al pie

Aquí hay una frase con una nota al pie. [^1]

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

Emoji

:smile: :heart: :rocket:

Resaltado

==texto resaltado==

Buenas prácticas

1. Mantenlo simple: Markdown está pensado para ser fácil de leer y de escribir.
2. Usa un formato consistente: mantén un mismo estilo para elementos similares.
3. Añade espacio en blanco: usa líneas vacías para separar secciones distintas.
4. Usa bien los encabezados: empieza por H1 y usa niveles inferiores para las subsecciones.
5. Escapa los caracteres especiales: usa la barra invertida para escaparlos.

Errores comunes

• Olvidar el espacio después de los encabezados
• No indentar correctamente las listas anidadas
• Mezclar distintos marcadores de lista
• No escapar los caracteres especiales cuando hace falta

Herramientas y recursos

• Markdown Guide
• Chuleta de Markdown
• Dillinger: editor de Markdown en línea
• Markdown Preview: herramienta de vista previa en vivo

Conclusión

Markdown es una herramienta potente para crear documentos bien formateados de forma rápida y eficiente. Ya sea que estés escribiendo documentación, tomando notas o creando contenido para la web, Markdown ofrece una manera simple pero efectiva de estructurar tu texto.

Recuerda: la mejor forma de aprender Markdown es practicando. Prueba a crear tus propios documentos y experimenta con los distintos elementos de la sintaxis.