Lección 1
¿Qué es Markdown?
Comprende Markdown como formato de texto plano para README, docs, incidencias y changelogs.
Markdown es un formato de texto plano para escribir documentos estructurados sin etiquetas HTML. En lugar de <h1>Title</h1>, escribes:
# Title
En lugar de <strong>important</strong>, escribes:
**important**
La idea es simple: mantener la fuente legible como texto, pero dejar que las herramientas la rendericen en encabezados, listas, enlaces y bloques de código.
Dónde usan Markdown los desarrolladores
Markdown aparece constantemente en flujos de trabajo de desarrolladores:
README.mden repositoriosCHANGELOG.mdcon notas de versión- Cuerpos de incidencias y pull requests de GitHub
- Sitios de docs que aceptan archivos
.md - Notas RFC, runbooks y guías internas
- Campos CMS o email que aceptan HTML convertido desde Markdown
Markdown vs HTML vs editores WYSIWYG
| Formato | Fortaleza | Uso típico |
|---|---|---|
| Markdown | Borrador rápido en texto plano, apto para diff | README, incidencias, fuente de docs |
| HTML | Control total de diseño, estilos inline | CMS, email, páginas web |
| WYSIWYG | Edición visual | Notion, Confluence, algunos CMS |
La mayoría de equipos mantienen Markdown en Git porque funciona bien con control de versiones, revisión de código y copiar/pegar entre herramientas.
Conclusión clave
Markdown es un formato de escritura, no un tema ni un renderizador. El mismo archivo Markdown puede verse distinto en GitHub, en un sitio de docs o en una herramienta de vista previa según el renderizador y el CSS.
Prueba la herramienta Vista previa Markdown / Markdown a HTML con una muestra corta de README para ver cómo el texto fuente se convierte en salida renderizada.