Guía Completa de Markdown: Sintaxis, Consejos y Usos Reales (2026)

¿Qué es Markdown?

Markdown es un lenguaje de marcado ligero creado por John Gruber en 2004. Permite formatear texto plano usando símbolos simples — asteriscos, almohadillas, corchetes — que se renderizan como HTML estilizado. La idea central: un archivo Markdown debe ser legible tal cual, incluso sin renderizarse.

Hoy, Markdown está en todas partes: READMEs de GitHub, sitios de documentación, plataformas de blogs (Ghost, Hashnode, Dev.to), aplicaciones de notas (Notion, Obsidian), herramientas de mensajería (Slack, Discord) y generadores de sitios estáticos (Jekyll, Hugo, Astro).

Encabezados

# H1 — Título de página
## H2 — Sección
### H3 — Subsección

Énfasis

**negrita**   *cursiva*   ~~tachado~~   `código en línea`

Listas y Tareas

- Elemento sin orden
1. Elemento ordenado
- [x] Tarea completada
- [ ] Tarea pendiente

Bloques de Código

```python
def saludar(nombre):
    return f"Hola, {nombre}!"
```

Tablas (GFM)

| Herramienta   | Categoría | ¿Gratis? |
|---------------|-----------|----------|
| JSON Formatter| Desarrollador | Sí   |

| Izquierda | Centro | Derecha |
|:----------|:------:|--------:|

Dónde se usa Markdown

• GitHub: README, wikis, comentarios en issues y pull requests
• Documentación: MkDocs, Docusaurus, GitBook, VitePress
• Notas: Obsidian, Notion, Bear, Joplin
• Blogs: Ghost, Hashnode, Dev.to, Jekyll, Hugo
• Mensajería: Slack, Discord, Mattermost
• IA: ChatGPT, Claude y Gemini renderizan respuestas en Markdown