Guía de Sintaxis Markdown: De lo Básico a lo Avanzado
Markdown es el formato de escritura que los desarrolladores realmente disfrutan usar. Sin hacer clic en menús de formato, sin pelear con editores WYSIWYG — solo texto plano con algunos símbolos que se convierte en HTML limpio. Archivos README, documentación, publicaciones de blog, mensajes de chat e incluso este artículo están escritos en Markdown.
Previsualiza tu Markdown en tiempo real con nuestro Previsualizador de Markdown — escribe en un lado, ve la salida formateada en el otro.
Sintaxis Básica
Encabezados
# Heading 1
## Heading 2
### Heading 3
#### Heading 4
Usa los encabezados de forma jerárquica. No saltes niveles (pasar de H1 a H3) — perjudica tanto la legibilidad como la accesibilidad.
Énfasis
*italic* or _italic_
**bold** or __bold__
***bold italic***
~~strikethrough~~
Enlaces e Imágenes
[Link text](https://example.com)
[Link with title](https://example.com "Title")
Listas
- Unordered item
- Another item
- Nested item
1. First item
2. Second item
3. Third item
Citas
> This is a blockquote.
> It can span multiple lines.
Código
Código en Línea
Usa comillas invertidas para código en línea: `const x = 42`
Bloques de Código
Triple comillas invertidas con un identificador de lenguaje opcional:
```javascript
function greet(name) {
return `Hello, ${name}!`;
}
```
Los lenguajes soportados incluyen javascript, python, json, yaml, html, css, bash y muchos más.
Tablas
| Header 1 | Header 2 | Header 3 |
|----------|----------|----------|
| Cell 1 | Cell 2 | Cell 3 |
| Cell 4 | Cell 5 | Cell 6 |
Alineación:
| Left | Center | Right |
|:-----|:------:|------:|
| L | C | R |
Sintaxis Avanzada
Listas de Tareas
- [x] Completed task
- [ ] Pending task
- [ ] Another task
Notas al Pie
Here is a statement[^1].
[^1]: This is the footnote content.
Listas de Definición
Term
: Definition of the term
Líneas Horizontales
---
***
___
GitHub-Flavored Markdown (GFM)
GitHub extiende el Markdown estándar con funcionalidades útiles:
- URLs con enlace automático — Las URLs simples se vuelven clicables
- Listas de tareas — Casillas de verificación en issues y PRs
- Tablas — La sintaxis de pipes mostrada arriba
- Tachado —
~~texto eliminado~~ - Resaltado de sintaxis — Coloreo de código específico por lenguaje
- Emoji —
:smile:se convierte en una cara sonriente
Consejos de Escritura
- Mantén los párrafos cortos — 3-5 oraciones como máximo
- Usa encabezados para crear una estructura escaneable
- Prefiere listas sobre párrafos largos para pasos o características
- Añade ejemplos de código cuando discutas conceptos técnicos
- Previsualiza regularmente — nuestro Previsualizador de Markdown muestra la salida mientras escribes
Preguntas Frecuentes
¿Cuál es la diferencia entre Markdown y HTML?
Markdown es un formato de escritura simplificado que se convierte a HTML. Cubre las necesidades de formato más comunes con mucha menos sintaxis. Puedes incrustar HTML crudo en Markdown cuando necesites funcionalidades que Markdown no soporta.
¿Qué variante de Markdown debería usar?
GitHub-Flavored Markdown (GFM) es la más ampliamente soportada. Añade tablas, listas de tareas y tachado al Markdown estándar. CommonMark es la especificación estandarizada.
¿Puedo usar Markdown para documentación?
Por supuesto. Markdown es el estándar para archivos README, wikis y sitios de documentación. Herramientas como MkDocs, Docusaurus y GitBook utilizan Markdown.
Recursos Relacionados
- Markdown vs Rich Text — por qué los desarrolladores prefieren texto plano
- Guía de Comparación de Texto — compara archivos Markdown
- Previsualizador de Markdown — previsualiza Markdown en tiempo real
- Herramienta de Comparación de Texto — compara archivos de texto y Markdown