Markdown
Una forma de escribir texto con formato usando símbolos sencillos (# para títulos, ** para negrita) que se lee bien incluso sin convertirlo.
✦Apagada: responde bien la pregunta del final para encenderla
También lo verás como: Markdown · md
Analogía
Las marcas que harías a mano en un papel —subrayar, poner un asterisco— convertidas en una convención que los programas entienden.
Ya lo usas
Todo este vault está escrito en Markdown. Cada nota que lees es un archivo .md.
Chuleta
| Escribes | Obtienes |
|---|---|
# Título / ## Subtítulo |
encabezados |
**negrita** / *cursiva* |
negrita / cursiva |
- elemento |
lista |
1. paso |
lista numerada |
[texto](https://...) |
enlace |
`código` |
código en línea |
- [ ] tarea |
casilla |
> cita |
cita |
Los bloques de código van entre tres acentos graves (```).
Dónde aparece en el oficio
- README.md y CLAUDE.md de cada proyecto
- Issues y pull requests en GitHub
- Documentación técnica
- Los prompts largos a la IA: Claude entiende muy bien la estructura en Markdown (títulos, listas, bloques).
No confundir con
- Los enlaces con doble corchete
[[así]]son de Obsidian, no de Markdown estándar. GitHub no los entiende.
Un paso más: por qué se impuso
Porque es texto plano con una ventaja que nadie más tiene: se entiende igual convertido que sin convertir. Un .md abierto en cualquier editor se lee sin problema; pasado por GitHub o por esta web, sale con títulos, negritas y tablas.
Eso lo hace perfecto para todo lo que rodea al código: se versiona con Git línea a línea, lo edita cualquiera, y la IA lo lee y lo escribe con total naturalidad.
Esta misma web está hecha con archivos Markdown: cada lección que lees es un .md convertido.
Compruébalo tú
Crea un archivo prueba.md, escribe un título con #, una lista con - y algo en **negrita**. Ábrelo en VS Code y pulsa Ctrl + Shift + V para ver el resultado.