Hay un momento en el que todos los que trabajamos en entornos digitales —ya sea programando, diseñando o escribiendo— nos cansamos de pelear con editores como Word o con interfaces llenas de botones.
Markdown es la respuesta sencilla a todo eso.
Es un lenguaje de marcado ligero que te permite escribir texto con formato sin pensar en cómo se ve, sino en qué estás diciendo.
Y eso, cuando quieres crear documentación o escribir con claridad, vale oro.
La base: escribir como piensas
Con Markdown, el texto se lee igual que se escribe.
Mira este ejemplo:
# Título principal
## Subtítulo
Esto es un **texto en negrita** y esto un *texto en cursiva*.
- Punto 1
- Punto 2
- Punto 3
[Enlace a mi web](https://example.com)
Listas: ordenadas y desordenadas
Desordenadas (se aceptan -, * o +):
- Elemento A
- Elemento B
- Subelemento B.1
- Subelemento B.2
* Otro estilo con asterisco
+ También con más
1. Paso uno
2. Paso dos
- Detalle A
1. Subpaso 1
2. Subpaso 2
3. Paso tres
Listas de tareas (GitHub-flavored Markdown):
- [x] Tarea completada
- [ ] Tarea pendienteEnlaces:
Enlace inline:
[Texto del enlace](https://example.com)Enlace con título (tooltip):
[Ejemplo (abre en nueva)](https://example.com "Visitar Example")
Enlaces relativos (útil en documentación MkDocs):
[Ir a la sección de instalación](instalacion.md)
[Ir a una subsección](docs/guia/uso.md#configuracion)Enlace por referencia (más limpio en documentos largos):
[Documentación oficial][doc]
[doc]: https://example.com/docs "Docs"
# ... y luego en el texto:
Consulta la [Documentación oficial][doc].Enlace mailto:
[Contacta conmigo](mailto:hola@example.com)
Imágenes:
Imágenes inline
Imagen local (en MkDocs: pon la imagen dentro de docs/images/):
Enlazar una imagen (hacerla clicable):
[](https://example.com/imagen-grande.png)Notas prácticas:
- Siempre rellena el alt text para accesibilidad.
- En MkDocs usa rutas relativas dentro de docs/ para que la build incluya las imágenes.