Markdown es un lenguaje de marcado ligero creado por John Gruber y Aaron Swartz. Su objetivo es permitir la escritura de texto plano con una sintaxis fácil de leer y escribir, que pueda convertirse fácilmente en HTML.
Es ampliamente utilizado en plataformas como GitHub, GitLab, Jupyter Notebooks, Google Colab, y sistemas de documentación como Read the Docs.
Principales ventajas de Markdown:
✅ Sencillez y legibilidad
✅ Conversión fácil a HTML y otros formatos
✅ Ideal para documentación técnica, tutoriales y blogs
✅ Compatible con herramientas modernas de desarrollo y aprendizaje
Encabezados en Markdown
Los encabezados permiten estructurar tu contenido en secciones, jerarquizando los títulos y subtítulos en distintos niveles, del H1 al H6.
La sintaxis es muy simple: se utilizan signos de numeral # al inicio de la línea.
# Título 1
## Título 2
### Título 3
#### Título 4
##### Título 5
###### Título 6
🔍 Vista previa:
Título 1
Título 2
Título 3
Título 4
Título 5
Título 6
📌 Sugerencias didácticas:
Utiliza # (H1) solo una vez, como título principal del documento.
Los subtítulos (##, ###, etc.) se usan para organizar el contenido jerárquicamente.
Evita saltarte niveles (no pases de H1 directo a H4).
En plataformas como GitHub o Jupyter, los encabezados se pueden plegar automáticamente para facilitar la navegación.
Estilos de Texto en Markdown
Markdown permite aplicar formatos de texto como cursiva, negrita, tachado y subrayado (con HTML). Estos estilos son útiles para enfatizar palabras clave o destacar ideas importantes.
📌 Cursiva
*Texto en cursiva* o _Texto en cursiva_
Texto en cursiva
📌 Negrita
**Texto en negrita** o __Texto en negrita__
Texto en negrita
📌 Tachado
~~Texto tachado~~
Texto tachado
📌 Subrayado (usando HTML)
<u>Texto subrayado</u>
Texto subrayado
💡 Ejemplos de combinaciones
**Texto en negrita y _cursiva_ combinados**
~~Texto tachado con **negrita**~~
*Cursiva con <u>subrayado</u>*
Texto en negrita y cursiva combinados
Texto tachado con negrita
Cursiva con subrayado
Enlaces en Markdown
Markdown permite insertar enlaces fácilmente usando una sintaxis muy legible. Es útil para redirigir a documentos, sitios web o recursos externos.
Utiliza enlaces descriptivos, evita usar textos como "haz clic aquí".
Verifica que los enlaces funcionen correctamente antes de compartir.
Para enlaces internos, puedes usar anclas HTML si el visor lo permite.
Inserción de Imágenes en Markdown
Markdown permite mostrar imágenes en línea con una sintaxis muy similar a los enlaces. La diferencia principal es el signo de exclamación ! al principio.
⚠️ Esto solo funciona si el archivo se encuentra accesible desde la misma ubicación del documento Markdown.
📌 Recomendaciones:
Incluye siempre un texto alternativo [texto] para accesibilidad.
Para portadas o logos, usa formatos livianos como .webp o .png.
Utiliza una resolución adecuada para evitar sobrecargar tu documento.
Inserción de Videos en Markdown
Markdown no tiene una sintaxis oficial para insertar videos como sí la tiene para imágenes o enlaces. Sin embargo, puedes insertar videos mediante HTML directamente, especialmente útil en plataformas como GitHub Pages, Jupyter Notebooks, o Google Colab.
🎥 Insertar videos alojados localmente (solo con HTML)
<video width="320" height="240" controls>
<source src="mi_video.mp4" type="video/mp4">
Tu navegador no soporta el elemento de video.
</video>
📌 Recomendaciones:
Usa videos alojados en YouTube o Vimeo para garantizar compatibilidad.
Utiliza la versión de enlace "embed" para insertar correctamente el video.
Si estás trabajando en Jupyter o Colab, asegúrate de que el entorno soporte iframes.
Listas en Markdown
Markdown permite crear listas ordenadas (numeradas) y no ordenadas (con viñetas). También puedes anidar listas fácilmente con sangrías.
📍 Lista no ordenada
- Elemento uno
- Elemento dos
- Sub-elemento dos.1
- Sub-elemento dos.2
- Elemento tres
Elemento uno
Elemento dos
Sub-elemento dos.1
Sub-elemento dos.2
Elemento tres
📍 Lista ordenada
1. Primer paso
2. Segundo paso
1. Detalle 2.1
2. Detalle 2.2
3. Tercer paso
Primer paso
Segundo paso
Detalle 2.1
Detalle 2.2
Tercer paso
📌 Recomendaciones:
Usa listas no ordenadas para enumeraciones generales.
Utiliza listas numeradas para procedimientos paso a paso.
Para sublistas, agrega al menos dos espacios o una tabulación.
Evita hacer listas muy profundas, ya que dificultan la lectura.
Tablas en Markdown
Markdown permite crear tablas simples para organizar información en filas y columnas. Aunque las funcionalidades son limitadas comparadas con HTML, son suficientes para representar datos de forma clara.
🧪 Sintaxis básica
| Nombre | Edad | Ciudad |
|--------|------|-----------|
| Ana | 23 | Bogotá |
| Luis | 30 | Medellín |
| Marta | 27 | Cali |
Nombre
Edad
Ciudad
Ana
23
Bogotá
Luis
30
Medellín
Marta
27
Cali
🔬 Ejemplo: Fragmento de la Tabla Periódica
| Elemento | Símbolo | Número Atómico |
|----------|---------|----------------|
| Hidrógeno | H | 1 |
| Helio | He | 2 |
| Litio | Li | 3 |
Elemento
Símbolo
Número Atómico
Hidrógeno
H
1
Helio
He
2
Litio
Li
3
🌌 Ejemplo: Planetas del Sistema Solar
| Planeta | Distancia al Sol (millones de km) | Días de rotación |
|-----------|------------------------------------|------------------|
| Mercurio | 57.9 | 59 |
| Venus | 108.2 | 243 |
| Tierra | 149.6 | 1 |
Planeta
Distancia al Sol (millones km)
Días de rotación
Mercurio
57.9
59
Venus
108.2
243
Tierra
149.6
1
📌 Recomendaciones:
Usa | para separar columnas y - para dividir encabezado y contenido.
Evita celdas con saltos de línea; mantén todo en una sola línea.
Si necesitas tablas más complejas (con celdas fusionadas), usa HTML.
Código en Python con Markdown
Para incluir fragmentos de código en Markdown, puedes usar comillas invertidas (`) para resaltar pequeñas líneas o bloques con tres tildes invertidas ```.
📌 Código en línea
`print("Hola Mundo")`
Resultado: print("Hola Mundo")
📌 Bloque de código en Python
```python
nombre = "Ana"
print(f"Hola, {nombre}")
```
nombre = "Ana"
print(f"Hola, {nombre}")
📌 Recomendaciones:
Utiliza la etiqueta del lenguaje después de las comillas invertidas para activar el resaltado de sintaxis.
En Colab, Jupyter o VS Code, los bloques se renderizan automáticamente.
Evita copiar comillas curvas o caracteres especiales invisibles.
Emojis en Markdown
En algunas plataformas como GitHub o Discord, puedes insertar emojis usando la sintaxis de dos puntos :emoji:.
😀 Ejemplos comunes
:smile: → 😄
:rocket: → 🚀
:heart: → ❤️
:book: → 📖
📚 Resultado en GitHub u otros visores compatibles: