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")
![Alt text](image.png)

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

---

🛠️ Pruébalo ahora: Markdown Previewer — 100% gratis, todo se procesa en tu navegador. Sin subir datos.

---