27 de noviembre de 2025

La Guía Completa de Markdown

Ejemplo de bordes animados con Tailwind CSS en un diseño oscuro, con un fondo de degradado vibrante.

Markdown es un lenguaje de marcado ligero que puedes usar para añadir elementos de formato a documentos de texto plano. Creado por John Gruber en 2004, Markdown es ahora 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___
~~Tachado~~

Listas

Listas Desordenadas

- Primer ítem
- Segundo ítem
- Tercer ítem
  - Ítem indentado
  - Otro ítem indentado

Listas Ordenadas

1. Primer ítem
2. Segundo ítem
3. Tercer ítem
   1. Ítem indentado
   2. Otro ítem indentado

Enlaces e Imágenes

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

Código

Código en Línea

Usa `código` en tu texto

Bloques de Código

```javascript
const hello = "world";
console.log(hello);
```

Citas en Bloque (Blockquotes)

> 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 la web
- [ ] Contactar con 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==

Mejores Prácticas

1. Mantenlo Simple: Markdown está pensado para ser fácil de leer y escribir.

2. Usa Formato Consistente: Mantén un estilo uniforme para elementos similares.

3. Agrega Espacios en Blanco: Usa líneas en blanco para separar secciones.

4. Usa Correctamente los Encabezados: Comienza con H1 y usa niveles inferiores para subsecciones.

5. Escapa Caracteres Especiales: Usa la barra invertida para escapar caracteres especiales.

Errores Comunes

  • Olvidar añadir espacios después de los encabezados

  • No indentar correctamente las listas anidadas

  • Mezclar diferentes marcadores de lista

  • No escapar caracteres especiales cuando es necesario

Herramientas y Recursos

Conclusión

Markdown es una herramienta poderosa 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 forma simple pero efectiva de estructurar tu texto.

Recuerda: ¡La mejor forma de aprender Markdown es practicar! Intenta crear tus propios documentos y experimenta con diferentes elementos de sintaxis.

Compartir