Guía Rápida Markdown

Una referencia rápida y lista para copiar para CommonMark y GitHub-Flavored Markdown (GFM). Cada bloque incluye ejemplos listos para usar y sugerencias de renderizado.

¿Quieres personalizar esta guía? Haz clic en Comenzar Edición para crear tu versión personalizada, luego exporta a Word o PDF.

Consejo: En md2word.com puedes pegar Markdown, luego convertir a .docx o .pdf con encabezados, tablas, imágenes, Mermaid adecuados.

Tabla de Contenidos

• Encabezados
• Párrafos y Saltos de Línea
• Énfasis
• Listas (ul/ol)
• Listas de Tareas (GFM)
• Enlaces
• Imágenes
• Código (inline y cercado)
• Bloques de Cita
• Línea Horizontal
• Tablas (GFM)
• Notas al Pie (GFM)
• Listas de Definición (algunos parsers)
• Matemáticas (LaTeX vía extensiones)
• Diagramas Mermaid
• Escape y Caracteres Especiales
• HTML en Markdown
• Notas de Plataforma: GitHub / Obsidian / Notion / Discord
• Preguntas Frecuentes

Encabezados

# H1
## H2
### H3
#### H4
##### H5
###### H6

Directriz: Usa un solo # H1 por página; usa H2–H4 jerárquicos para estructura.

Párrafos y Saltos de Línea

• Una línea en blanco comienza un nuevo párrafo.
• Termina una línea con dos espacios o añade <br> para un salto de línea.

Primera línea con dos espacios␠␠
salto de línea forzado.

Énfasis

*cursiva*  _cursiva_
**negrita**  __negrita__
***negrita cursiva***
~~tachado~~

Listas (ul/ol)

No ordenadas

- Elemento A
- Elemento B
  - Anidado 1
  - Anidado 2

Ordenadas

1. Primero
2. Segundo
3. Tercero

Consejo: Los números se auto-incrementan; 1. para todos los elementos es válido en muchos parsers.

Listas de Tareas (GFM)

- [ ] Por hacer
- [x] Hecho

Enlaces

[md2word](https://md2word.com)
<https://md2word.com>               # autoenlace
[título](https://url "título al pasar")  # título opcional

Estilo de referencia

[Inicio][home]

[home]: https://md2word.com

Imágenes

![texto alt](https://example.com/img.png "título opcional")

Con ancho (fallback HTML)

<img src="https://example.com/img.png" alt="desc" width="480">

Código (inline y cercado)

El código inline usa backticks: Usa \código` para código inline`

Bloques cercados

```language
# tu código...
```

Lenguajes comunes: bash, python, javascript, json, yaml, mermaid

Bloques de Cita

> Un nivel
>> Anidado

Línea Horizontal

---
***
___

Tablas (GFM)

| Característica | Soporte |
|---|---|
| Tablas | ✅ |
| Alineación | ✅ |

Alineación

| Izquierda | Centro | Derecha |
|:---------|:------:|--------:|
| a         |    b   |        c |

Notas al Pie (GFM)

Aquí hay una referencia de nota al pie.[^1]

[^1]: El texto de la nota al pie.

Listas de Definición (algunos parsers)

Término
: Definición 1
: Definición 2

Matemáticas (LaTeX vía extensiones)

Requiere un renderizador como KaTeX/MathJax.

Inline: $E=mc^2$
Bloque:

$$
\nabla \cdot \vec{E} = \frac{\rho}{\varepsilon_0}
$$

Diagramas Mermaid

```mermaid
flowchart TD
  A[Inicio] --> B{¿Elección?}
  B -->|Sí| C[Ruta 1]
  B -->|No|  D[Ruta 2]
```

En md2word.com, Mermaid se renderiza como imágenes para exportación PDF/Word limpia.

Escape y Caracteres Especiales

Usa backslash para escapar formato:

\*no cursiva\*  \#no un encabezado

HTML en Markdown

La mayoría de los parsers permiten un subconjunto de HTML:

<details><summary>Alternar</summary>
Contenido oculto
</details>

Notas de Plataforma: GitHub / Obsidian / Notion / Discord

• GitHub (GFM): soporta tablas, listas de tareas, tachado, autoenlace. Sin HTML crudo en algunos contextos (READMEs generalmente OK).
• Obsidian: soporta wikilinks internos [[Nota]], callouts > [!note].
• Notion: importa Markdown, pero algunas sintaxis avanzadas pueden ser normalizadas.
• Discord/Reddit: subconjuntos limitados; las tablas pueden no renderizarse — usa bloques de código.

Preguntas Frecuentes

P: ¿Qué estándar sigue esta guía? Principalmente CommonMark con adiciones GFM (tablas, listas de tareas, tachado, autoenlace).

P: ¿Cómo obtengo una versión PDF/Word? Haz clic en Comenzar Edición para abrir esta guía en nuestro editor, personaliza según necesites, luego exporta a .pdf o .docx. O pega cualquier Markdown en md2word.com para conversión directa.

P: ¿Por qué mis tablas se rompen en Word? Usa la conversión md2word — las tablas se normalizan a tablas DOCX con bordes y alineación consistentes.

Registro de Cambios

• 2025-10-16: Versión española. Cubre CommonMark + GFM, incluye notas Mermaid y Math.

¿Te gusta esto? Dale estrella al repositorio GitHub (si aplica) y comparte. Consejo pro: Explora más: Guía de Tablas Markdown, Hipervínculos Markdown, Markdown a PDF.