Por qué la jerarquía cambia la utilidad del documento
Un documento escaneable reduce tiempo de lectura, dudas y mantenimiento futuro.
Cuando una persona abre un README o una nota técnica, rara vez lo lee de arriba abajo con calma. Primero escanea títulos, detecta bloques y busca dónde entrar.
Si usas encabezados con sentido, el lector identifica rápido qué es contexto, qué es instrucción y qué parte puede ignorar por ahora. Esa es la diferencia entre un documento usable y uno solo correcto en sintaxis.
La jerarquía también ayuda al autor futuro: volver a tu propio archivo dentro de dos meses será mucho más fácil si la estructura ya estaba clara.
- Un `#` define el marco principal del documento.
- Los `##` separan bloques grandes de lectura o decisión.
- Los `###` solo tienen sentido cuando de verdad subdividen una sección anterior.
- Los párrafos cortos ayudan a que cada bloque cumpla una sola función.
