13. ¿Qué es Markdown?#
Es un lenguaje simple inventado por John Gruber en 2004 para escribir texto que se convierte en HTML bonito. Se usa en sitios como Reddit, GitHub y Jupyter Notebook.
13.1. Usa solo Markdown cuando requieras:#
✅ Que el texto sea legible incluso sin renderizar.
✅ Formato básico (negritas, cursivas, listas, enlaces simples).
✅ Escribir en plataformas que solo soportan Markdown estándar.
✅ Simplicidad y rapidez.
💡 ¿Qué es Renderizar?
Convertir el código Markdown en su versión visual final.
Siempre debes revisar la “vista previa” (versión renderizada) antes de publicar, ya que diferentes plataformas pueden renderizar el mismo Markdown de forma levemente distinta.
13.2. Incorpora HTML cuando necesites:#
✅ Alineación de texto específica: centrado, justificado, derecha.
✅ Colores o tamaños de fuente personalizados.
✅ Espaciado o márgenes específicos.
✅ Tablas más complejas con celdas combinadas.
✅ Centrar imágenes o controlar su tamaño exacto.
✅ Markdown puro no pueda hacer lo que necesitas.
✅ Control visual más preciso sobre el diseño.
13.3. Alineación de textos#
Texto alineado a la izquierda: Es el modelo por defecto.
Texto centrado: Es útil para títulos o frases destacadas.
Texto alineado a la derecha: Lo usamos con menos frecuencia.
Texto justificado: El texto se ajusta a ambos márgenes.
13.4. 📘 Ejemplos básicos de Markdown#
En esta sección verás primero cómo se escribe (la sintaxis) y luego cómo se ve (el resultado renderizado).
13.4.1. Encabezados (Títulos)#
Los encabezados se crean con el símbolo #. Mientras más #, más pequeño el título.
Escribe esto:
# Título nivel 1 (el más grande)
## Título nivel 2
### Título nivel 3
#### Título nivel 4
##### Título nivel 5
###### Título nivel 6 (el más pequeño)
Obtienes esto:
Título nivel 1
Título nivel 2
Título nivel 3
Título nivel 4
Título nivel 5
Título nivel 6 (el más pequeño)
13.4.2. Negrita y cursiva#
Formato |
Sintaxis |
Resultado |
|---|---|---|
Negrita |
|
texto |
Cursiva |
|
texto |
Negrita y cursiva |
|
texto |
Tachado |
|
~~texto~~ |
13.4.2.1. Ejemplos históricos:#
Escribe esto:
**Bernardo O'Higgins fue el Padre de la Patria chilena.**
*La Batalla de Maipú se libró el 5 de abril de 1818.*
***Simón Bolívar fue conocido como El Libertador.***
~~Octavio perdió en Actium~~ (fue Marco Antonio)
Obtienes esto:
Bernardo O’Higgins fue el Padre de la Patria chilena.
La Batalla de Maipú se libró el 5 de abril de 1818.
Simón Bolívar fue conocido como El Libertador.
~~Octavio perdió en Actium~~ (fue Marco Antonio)
13.4.3. Listas#
13.4.3.1. Con viñetas#
Escribe esto:
- Bernardo O'Higgins
- José de San Martín
* Manuel Rodríguez
* Javiera Carrera
Obtienes esto:
Bernardo O’Higgins
José de San Martín
Manuel Rodríguez
Javiera Carrera
13.4.3.2. Listas numeradas#
Escribe esto:
1. Primera Cruzada (1096-1099)
2. Segunda Cruzada (1147-1149)
3. Tercera Cruzada (1189-1192)
Obtienes esto:
Primera Cruzada (1096-1099)
Segunda Cruzada (1147-1149)
Tercera Cruzada (1189-1192)
13.4.3.3. Lista de tareas (checkboxes)#
Escribe esto:
- [x] Conquistar el Imperio Persa
- [ ] Llegar hasta la India
- [ ] Conquistar Arabia (murió antes)
- [ ] Invadir el oeste hacia Cartago
Obtienes esto:
Conquistar el Imperio Persa
Llegar hasta la India
Conquistar Arabia (murió antes)
Invadir el oeste hacia Cartago
13.4.3.4. Listas anidadas#
Escribe esto:
- Mundo Antiguo
- Imperio Romano (27 a.C. - 476 d.C.)
- Imperio Chino Han (206 a.C. - 220 d.C.)
1. Edad Media
1. Imperio Bizantino (330-1453)
2. Imperio Carolingio (800-888)
Obtienes esto:
Mundo Antiguo
Imperio Romano (27 a.C. - 476 d.C.)
Imperio Chino Han (206 a.C. - 220 d.C.)
Edad Media
Imperio Bizantino (330-1453)
Imperio Carolingio (800-888)
13.4.4. Citas (blockquotes)#
Escribe esto:
> "Alea iacta est" (La suerte está echada).
> - Julio César al cruzar el Rubicón (49 a.C.).
Obtienes esto:
“Alea iacta est” (La suerte está echada).
Julio César al cruzar el Rubicón (49 a.C.).
Escribe esto:
> "Veni, vidi, vici" (Vine, vi, vencí).
> Julio César tras la Batalla de Zela (47 a.C.).
Obtienes esto:
“Veni, vidi, vici” (Vine, vi, vencí).
Julio César tras la Batalla de Zela (47 a.C.).
13.4.5. Líneas horizontales#
Sirven para separar secciones visualmente.
Escribe cualquiera de estas opciones:
---
***
___
Obtienes esto:
13.4.6. Código#
13.4.6.1. Código en línea (inline)#
Escribe esto:
Para ejecutar un comando escribe: `print("Hola")`
Obtienes esto:
Para ejecutar un comando escribe: print("Hola")
13.4.6.2. Bloques de código#
Escribe esto:
```python
for i in range(2):
print("Para recordar la caída de Constantinopla: 29 de mayo de 1453")
```
Obtienes esto:
for i in range(2):
print("Para recordar la caída de Constantinopla: 29 de mayo de 1453")
💡 Tip: Lenguajes soportados
Puedes especificar el lenguaje después de los tres backticks para que el código tenga colores (syntax highlighting):
pythonpara Pythonjavascriptpara JavaScripthtmlpara HTMLcsspara CSSbashpara comandos de terminal
13.4.7. Enlaces e imágenes#
13.4.7.1. Enlaces web#
Escribe esto:
- [YouTube](https://youtube.com)
- [Instagram](https://instagram.com)
- [Museo Histórico Nacional](https://www.mhn.gob.cl/)
Obtienes esto:
13.4.7.2. Imágenes#
Escribe esto:
Obtienes esto:
13.4.7.3. Centrar imagen con HTML#
Escribe esto:
<p align="center">
<img src="https://img.shields.io/badge/Chile-Independencia_1818-red?style=for-the-badge" alt="Chile" width="200">
</p>
Obtienes esto:
13.4.8. Tablas#
Escribe esto:
| Faraón | Dinastía | Año de Reinado |
| ------ | -------- | -------------- |
| Narmer | I | 3100 a.C. |
| Keops | IV | 2589-2566 a.C. |
| Tutankamón | XVIII | 1332-1323 a.C. |
Obtienes esto:
Faraón |
Dinastía |
Año de Reinado |
|---|---|---|
Narmer |
I |
3100 a.C. |
Keops |
IV |
2589-2566 a.C. |
Tutankamón |
XVIII |
1332-1323 a.C. |
13.4.8.1. Alineación en tablas#
Escribe esto:
| Batalla | Año | Ganador | Consecuencia |
| :------ | :---: | :---: | ------: |
| Maratón | 490 a.C | Atenas | Salvó a Grecia |
| Hastings | 1066 | Normandos | Conquistó Inglaterra |
| Waterloo | 1815 | Coalición | Fin de Napoleón |
Obtienes esto:
Batalla |
Año |
Ganador |
Consecuencia |
|---|---|---|---|
Maratón |
490 a.C |
Atenas |
Salvó a Grecia |
Hastings |
1066 |
Normandos |
Conquistó Inglaterra |
Waterloo |
1815 |
Coalición |
Fin de Napoleón |
📝 Nota sobre alineación
Los dos puntos (:) controlan la alineación:
:---= izquierda:---:= centrado---:= derecha
13.4.9. Separación de párrafos#
13.4.9.1. 👎 Error común: no separar#
Escribe esto:
La Revolución Francesa comenzó en 1789.
Napoleón tomó el poder en 1799.
Fue derrotado en Waterloo en 1815.
Obtienes esto (todo junto):
La Revolución Francesa comenzó en 1789. Napoleón tomó el poder en 1799. Fue derrotado en Waterloo en 1815.
13.4.9.2. ✅ Solución 1: Línea en blanco entre párrafos#
Escribe esto:
La Revolución Francesa comenzó en 1789.
Napoleón tomó el poder en 1799.
Fue derrotado en Waterloo en 1815.
Obtienes esto:
La Revolución Francesa comenzó en 1789.
Napoleón tomó el poder en 1799.
Fue derrotado en Waterloo en 1815.
13.4.9.3. ✅ Solución 2: Usar <br> para salto de línea#
Escribe esto:
La Revolución Francesa comenzó en 1789.<br>
Napoleón tomó el poder en 1799.<br>
Fue derrotado en Waterloo en 1815.
Obtienes esto:
La Revolución Francesa comenzó en 1789.
Napoleón tomó el poder en 1799.
Fue derrotado en Waterloo en 1815.
13.4.9.4. ✅ Solución 3: Dos espacios al final de línea#
Escribe esto (con dos espacios antes del Enter):
La Revolución Francesa comenzó en 1789.
Napoleón tomó el poder en 1799.
Fue derrotado en Waterloo en 1815.
Obtienes esto:
La Revolución Francesa comenzó en 1789.
Napoleón tomó el poder en 1799.
Fue derrotado en Waterloo en 1815.
13.4.10. Escapar caracteres especiales#
¿Qué pasa si quieres mostrar los símbolos de Markdown sin que se conviertan en formato?
Usa la barra invertida \ antes del carácter.
Escribe esto:
\*Esto NO es cursiva\*
\*\*Esto NO es negrita\*\*
\# Esto NO es un título
Obtienes esto:
*Esto NO es cursiva*
**Esto NO es negrita**
# Esto NO es un título
📝 Caracteres que puedes escapar
Carácter |
Nombre |
|---|---|
|
Barra invertida |
|
Asterisco |
|
Guión bajo |
|
Numeral |
|
Más |
|
Menos |
|
Punto |
|
Exclamación |
|
Corchetes |
|
Paréntesis |
13.4.11. Notas al pie de página#
Escribe esto:
La Batalla de Maipú[^1] fue decisiva para la independencia de Chile.
[^1]: Se libró el 5 de abril de 1818 en los llanos de Maipú.
Obtienes esto:
La Batalla de Maipú[1] fue decisiva para la independencia de Chile.
⚠️ Importante
Las notas al pie funcionan en Jupyter Book y GitHub, pero no en todos los editores de Markdown. Verifica si tu plataforma las soporta.
13.4.12. Cuadros especiales (Admonitions) - Solo Jupyter Book#
En Jupyter Book puedes crear cuadros de colores para destacar información:
Escribe esto:
```{admonition} 💡 Título del tip
:class: tip
Este es un consejo útil para tus estudiantes.
```
Tipos de admonitions:
Clase |
Color |
Uso |
|---|---|---|
|
Verde |
Consejos útiles |
|
Azul |
Información adicional |
|
Amarillo |
Advertencias |
|
Rojo |
Errores comunes |
|
Azul claro |
Referencias |
13.5. 📋 Resumen rápido de sintaxis#
Elemento |
Sintaxis |
|---|---|
Negrita |
|
Cursiva |
|
Tachado |
|
Código inline |
|
Enlace |
|
Imagen |
|
Encabezado |
|
Lista con viñeta |
|
Lista numerada |
|
Cita |
|
Línea horizontal |
|
Checkbox |
|
Escapar carácter |
|
Nota al pie |
|
13.5.1. 📘 Ejemplos básicos de Markdown con emojis:#
⚔️ Guerras: 🏛️ Roma vs 🐘 Cartago.
👑 En títulos: # Los Reyes Católicos 👑
🔍 Busca símbolos históricos en 👉 emojipedia
13.6. 🛠️ Herramientas para practicar Markdown#
13.6.1. Editores online (ideales para comenzar)#
💻 Dillinger.io - Editor simple con vista previa en tiempo real
💻 StackEdit - Más avanzado, guarda en la nube
💻 Markdown Live Preview - Súper simple para práctica rápida
13.6.2. Aplicaciones de escritorio#
13.6.3. Recursos adicionales#
🔗 Markdown Guide: Referencia completa
⚙️ GitHub Flavored Markdown: Variante de GitHub
📜 CommonMark: Especificación estándar
📚 Jupyter Book Docs: Para admonitions y más
13.7. ✏️ Ejercicios para practicar#
Elige dos de estas opciones y profundiza en el uso de Markdown:
🏛️ Civilización antigua: Egipto, Roma, Grecia. Usa títulos, tablas de faraones/emperadores, enlaces a museos.
⚔️ Batalla histórica: Describe Maipú, Waterloo, Stalingrado. Practica con mapas, cronologías, listas de consecuencias.
👑 Biografía de personaje: Napoleón, Cleopatra, O’Higgins. Usa citas famosas, líneas de tiempo, imágenes.
🗺️ Línea de tiempo: Guerra del Pacífico, Revolución Francesa, Caída del Imperio Romano.
🎭 Historia alternativa: “¿Qué habría pasado si…?”
Julio César no cruzara el Rubicón
Napoleón ganara en Waterloo
Los aztecas hubieran tenido caballos
🏛️ Comparación de imperios: Romano vs Chino Han, Inca vs Azteca.
📚 Reseña de libro histórico: “Los Miserables”, “Guerra y Paz”, “Yo, Claudio”
💡 Recuerda
👀 Siempre revisa cómo se ve tu Markdown renderizado.
📏 Los espacios y saltos de línea son importantes.
⚠️ Lo que escribes no siempre es lo que obtienes.
💪 Empieza con alguno de los proyectos antes mencionados en lugar de solo hacer ejercicios. ¡Aprenderás mucho más rápido!
💡 Recuerda al documentar historia
👀 Siempre cita tus fuentes históricas
📅 Las fechas y cronologías son cruciales
⚠️ Distingue entre hechos verificados e hipótesis
💪 Empieza con períodos que te apasionen: ¡aprenderás mucho más rápido!
🔍 Usa fuentes primarias cuando sea posible
🌍 Considera múltiples perspectivas culturales de los eventos