Hoja de trucos de Markdown
Elige un tema de Markdown
Empieza por un grupo de ejemplos y después abre la referencia completa.
Sintaxis esencial de Markdown, agrupada por categorías y mostrada con el código listo para copiar y la salida de un analizador real. Incluye las bases de CommonMark (encabezados, listas, énfasis, enlaces, imágenes y código cercado) y extensiones de GitHub Flavored Markdown (tablas, listas de tareas, tachado y enlaces automáticos de URL sin formato). Tenla a mano cuando cambies entre GitHub, GitLab, Obsidian y generadores de sitios estáticos.
Cómo usar la hoja de trucos
-
1
Navegar por categoría
Filtra la referencia completa o elige un tema en la vista guiada.
-
2
Comparar fuente y resultado
Cada ejemplo muestra el Markdown en bruto junto a la salida de un analizador GFM real.
-
3
Copia el fragmento
Toca copiar para obtener el código fuente de cualquier ejemplo.
-
4
Revisa la etiqueta de sintaxis
Cada ejemplo está marcado como CommonMark o GitHub Flavored Markdown (GFM).
Encabezados
# Título H1
## Sección H2
### Subsección H3
Usa el estilo ATX (#) en lugar de Setext (=== debajo del texto). Todos los analizadores soportan ambos, pero ATX es más fácil de leer en un diff.
Énfasis
*cursiva* o _cursiva_, **negrita** o __negrita__, ***negrita cursiva***. GFM añade ~~tachado~~.
Listas
Las listas desordenadas usan -, * o + (elige uno y no lo cambies):
- Primero
- Segundo
- Anidado (dos espacios)
Las listas ordenadas se renumeran automáticamente:
1. Elemento
1. Elemento
1. Elemento
Código
En línea: `código`. Bloques cercados con etiqueta de lenguaje opcional:
```python
def hello(name):
return f"Hola, {name}"
```
Indenta con cuatro espacios para un bloque de código si prefieres la sintaxis más antigua.
Enlaces e imágenes
[Texto del enlace](https://example.com)
[Enlace con título](https://example.com "Tooltip")

El estilo de referencia mantiene URLs largas fuera del párrafo:
Consulta los [docs][1].
[1]: https://example.com/docs
Tablas (GFM)
| Col A | Col B |
|-------|------:|
| a | 1 |
| b | 22 |
La alineación usa dos puntos en la fila separadora: :--- izquierda, :---: centro, ---: derecha.
Listas de tareas (GFM)
- [x] Hecho
- [ ] Por hacer
Problemas comunes
- Dos espacios finales insertan un salto de línea dentro de un párrafo. Un espacio solo une las líneas.
- Línea en blanco requerida antes de la mayoría de los elementos de bloque (encabezados, listas, bloques de código).
- No indentes los marcadores de lista con tabulaciones si tu renderizador espera espacios; indenta con dos o cuatro espacios.
- Escapa con barra invertida para puntuación literal:
\*no cursiva\*. - Comillas inteligentes difieren según el renderizador. GitHub las deja como están; Pandoc las convierte.
Preguntas frecuentes
CommonMark define el núcleo portable, incluidos encabezados, listas, enlaces y código cercado con una etiqueta informativa opcional. GFM añade tablas, listas de tareas, tachado y enlaces automáticos para URL sin formato. Otros editores pueden implementar solo una parte o añadir extensiones propias.
En un archivo Markdown, un único salto de línea suele ser un salto suave. Para crear un salto duro en CommonMark o GFM, termina la primera línea con dos espacios o una barra invertida.
CommonMark reconoce HTML en bruto, pero cada plataforma decide si lo permite, lo limpia o lo escapa. GitHub limpia el HTML renderizado y esta guía lo escapa en las vistas previas por seguridad.
CommonMark no incluye una sintaxis de tabla de contenido. GitHub crea anclas de encabezado y muestra un esquema en archivos con varios encabezados. Otras plataformas tienen sus propias reglas: MkDocs puede usar [TOC] con la extensión correspondiente y Docusaurus genera la tabla de contenido a partir de los encabezados.
Los ejemplos de CommonMark y muchos de GFM sí. Obsidian también admite wikilinks ([[Nombre de la página]]), callouts e incrustaciones propios; esas extensiones quedan fuera de esta guía.
Herramientas relacionadas
Generador de letras aleatorias
Genera letras aleatorias A-Z. Elige la cantidad, usa mayúsculas, minúsculas o mezcla de ambas, y aplica el resultado en juegos, consignas o clase.
Formateador de JSON
Pega JSON para verlo con sangría de 2 o 4 espacios, minificarlo en una salida compacta o comprobar rápidamente la sintaxis antes de copiar el resultado.
Simplificador de Álgebra Booleana
Simplifica expresiones booleanas usando mapas de Karnaugh y el algoritmo de Quine-McCluskey. Muestra cada paso de minimización y una forma final SOP/POS.
Generador de Paletas de Color
Genera paletas monocromáticas, análogas, complementarias, triádicas o tetrádicas desde un color base HEX y exporta variables CSS listas para copiar.
Generador de colores aleatorios
Genera de 1 a 50 colores HEX aleatorios con muestras para previsualizar, copiar y usar en CSS, pruebas o exploración de paletas.
Convertidor de BBCode a HTML
Convierte BBCode (marcado de tablones de anuncios) a HTML limpio. Maneja etiquetas de formato, listas, citas, código, imágenes y enlaces.