La guía completa de Markdown - De básico a avanzado

Introducción: ¿Qué es Markdown?

Markdown es un lenguaje de marcado ligero creado por John Gruber en 2004. Su objetivo principal es ser lo más legible posible en su forma bruta mientras sigue siendo convertible a HTML válido. Hoy en día, Markdown se ha convertido en el estándar de facto para escribir contenido en la web — desde documentación y archivos README hasta publicaciones de blog, comentarios y plataformas de mensajería.

¿Quieres practicar mientras lees esta guía? Prueba nuestra herramienta de Vista previa Markdown para ver tu Markdown renderizado en tiempo real.

¿Por qué usar Markdown?

• Legibilidad: El Markdown en bruto es fácil de leer, incluso sin renderizar
• Portabilidad: Los archivos Markdown son texto plano y funcionan en cualquier lugar
• Simplicidad: La sintaxis es intuitiva y fácil de aprender
• Amplio soporte: Usado por GitHub, GitLab, Reddit, Stack Overflow, Notion, Obsidian y muchos más
• Compatible con control de versiones: Al ser texto plano, Markdown funciona perfectamente con Git
• Convertible: Markdown puede convertirse a HTML, PDF, DOCX y muchos otros formatos
• Enfoque en el contenido: Markdown te permite enfocarte en escribir en lugar de en el formato

Sintaxis básica

Encabezados

Los encabezados se crean añadiendo de uno a seis símbolos # antes del texto del encabezado:

# Encabezado 1 (H1)
## Encabezado 2 (H2)
### Encabezado 3 (H3)
#### Encabezado 4 (H4)
##### Encabezado 5 (H5)
###### Encabezado 6 (H6)

Mejores prácticas para encabezados:

• Siempre pon un espacio entre # y el texto del encabezado
• Usa solo un H1 por documento (generalmente el título)
• No saltes niveles de encabezado (ve de H2 a H3, no de H2 a H4)
• Mantén los encabezados concisos y descriptivos

Énfasis (Negrita y Cursiva)

*texto en cursiva* o _texto en cursiva_

**texto en negrita** o __texto en negrita__

***negrita y cursiva*** o ___negrita y cursiva___

~~texto tachado~~

Citas en bloque

> Esto es una cita en bloque.
>
> Puede abarcar múltiples párrafos.

> Las citas se pueden anidar.
>
>> Esta es una cita anidada.

Listas

Listas desordenadas con -, * o +:

- Elemento 1
- Elemento 2
  - Subelemento 2.1
  - Subelemento 2.2
- Elemento 3

Listas ordenadas con números seguidos de puntos:

1. Primer elemento
2. Segundo elemento
3. Tercer elemento

Enlaces e imágenes

Enlaces

[Texto del enlace](https://example.com)

[Enlace con título](https://example.com "Título del enlace")

<https://example.com> (enlace automático)

Imágenes

![Texto alternativo](url-imagen.png)

![Texto alternativo](url-imagen.png "Título de la imagen")

Código

Código en línea

Envuelve el código en línea con comillas simples:

Usa la función `console.log()` para depurar.

Bloques de código

Usa triple comillas con un identificador de lenguaje opcional para el resaltado de sintaxis:

```javascript
function greet(name) {
  return `Hello, ${name}!`;
}
```

```python
def greet(name):
    return f"Hello, {name}!"
```

Tablas

Las tablas se crean usando barras verticales (|) y guiones (-):

| Característica | Plan gratuito | Plan Pro | Empresa |
|----------------|--------------|---------|---------|
| Usuarios | 1 | 10 | Ilimitado |
| Almacenamiento | 1 GB | 100 GB | 1 TB |
| Soporte | Comunidad | Email | Teléfono 24/7 |

Resultado renderizado:

Característica	Plan gratuito	Plan Pro	Empresa
Usuarios	1	10	Ilimitado
Almacenamiento	1 GB	100 GB	1 TB
Soporte	Comunidad	Email	Teléfono 24/7

GitHub Flavored Markdown (GFM)

Listas de tareas

- [x] Configuración del proyecto completada
- [x] Documentación escrita
- [ ] Añadir pruebas unitarias
- [ ] Desplegar en producción

Resultado renderizado:

• Configuración del proyecto completada
• Documentación escrita
• Añadir pruebas unitarias
• Desplegar en producción

Emoji

GFM soporta códigos cortos de emoji:

:smile: :rocket: :bug: :white_check_mark: :warning:

Notas al pie

Esta afirmación necesita una fuente[^1].

[^1]: Fuente: Journal of Computer Science, 2026.

Alertas de GitHub

> [!NOTE]
> Información útil que los usuarios deben saber.

> [!WARNING]
> Información urgente que requiere atención inmediata.

Mejores prácticas de Markdown

1. Comenzar con un solo H1: Este suele ser el título del documento
2. Usar encabezados de forma jerárquica: H2 para secciones principales, H3 para subsecciones
3. Mantener párrafos cortos: Apuntar a 3-5 oraciones por párrafo
4. Siempre especificar el lenguaje: Usar bloques de código con identificadores de lenguaje
5. Usar texto de enlace descriptivo: Evitar "haz clic aquí", usar texto significativo

Referencia rápida de Markdown

Elemento	Sintaxis	Notas
Encabezado	# H1 a ###### H6	Espacio después de #
Negrita	**texto**	O __texto__
Cursiva	*texto*	O _texto_
Tachado	~~texto~~	Función de GFM
Cita	> texto	Anidable
Lista ordenada	1. elemento	Números auto-incrementados
Lista desordenada	- elemento	También * o +
Código en línea	`código`	Comillas simples
Bloque de código	```	Triple comillas
Enlace	[texto](url)	Título opcional
Imagen		Título opcional
Línea horizontal	---	También *** o ___
Tabla	| col | col |	Función de GFM
Lista de tareas	- [x] hecho	Función de GFM
Nota al pie	texto[^1]	No universal

Conclusión

Markdown es una herramienta poderosa y sencilla que todo desarrollador y escritor técnico debería conocer. Su formato de texto plano lo hace perfecto para documentación con control de versiones, publicaciones de blog, archivos README y mucho más.

Para practicar la escritura en Markdown y ver tu trabajo renderizado al instante, prueba nuestra herramienta gratuita de Vista previa Markdown.

Recursos relacionados

• Herramienta de vista previa Markdown — Previsualiza tu Markdown en tiempo real
• Contador de palabras — Cuenta palabras en tus documentos Markdown
• Formateador JSON — Formatea JSON para ejemplos de código
• Guía de regex para principiantes — Aprende regex para procesamiento de texto