Saltar a contenido

✍️ Metodología de Apuntes y Notas

Consejos prácticos para estructurar apuntes claros, mantenibles y fáciles de consultar.


🎯 Principio de una nota por concepto (Atomic Notes)

  • Claridad: Cada nota o página debe centrarse en un único tema o concepto bien delimitado.
  • Títulos explícitos: Usa títulos que anticipen la respuesta o el contenido (e.g. ¿Cómo configurar SSL con Nginx? en vez de solo SSL).
  • Resúmenes en la cabecera: Una breve introducción de 2 líneas ayuda a situarse antes de profundizar.

🎨 Uso de cajas de texto (Admonitions)

Material for MkDocs incluye multitud de tipos de avisos visuales:

Nota estándar

Úsala para contexto adicional o notas al margen.

Consejo o Tip

Ideal para atajos, trucos o atajos de teclado.

Atención o Aviso

Advierte sobre posibles errores comunes o incompatibilidades.

Peligro

Para acciones destructivas o comandos irreversibles.


✅ Listas de tareas pendientes

  • Configurar MkDocs con tema Material
  • Crear estructura inicial de carpetas
  • Personalizar categorías y apuntes personales
  • Desplegar en GitHub Pages o Cloudflare Pages