Cómo dejar de configurar wikis y empezar a escribir documentación

Una historia conocida: tu equipo o tú personalmente necesitan una base de conocimientos. Abres Wiki.js, Outline o, Dios no lo quiera, Confluence. Una hora después, te encuentras profundamente inmerso en la configuración de PostgreSQL, Redis, almacenamiento S3 y un archivo Docker Compose de trescientas líneas. En este punto, la urgencia de anotar un par de ideas inteligentes generalmente desaparece.

Hace poco me encontré con LeafWiki. El autor del proyecto aparentemente comparte este dolor. Es un wiki autoalojado sin florituras que funciona bajo el principio de "descarga y ejecuta". Sin dependencias pesadas, solo un único binario Go y una carpeta de datos.

Bajo el Capó

LeafWiki no intenta reinventar la rueda. Se apoya en tres cosas sencillas: Go para el backend, React para la interfaz y SQLite para los metadatos. Lo mejor: el contenido real de las páginas se almacena en archivos Markdown planos en disco.

Esto significa que si el servidor se cae de repente o decides mudarte a otra herramienta, tus datos no se convertirán en una calabaza atrapada dentro de una base de datos propietaria. Puedes abrirlo con cualquier editor de texto o incluso Obsidian.

Qué la Hace Buena en la Práctica

A menudo veo herramientas que se llaman a sí mismas "simples" pero que en realidad requieren administración completa. LeafWiki es más honesta al respecto.

Estructura de Árbol en Lugar del Caos

Muchas herramientas modernas de toma de notas tienden hacia listas "planas" con etiquetas. Aquí obtienes una estructura de árbol clásica. Tú defines la jerarquía y, lo que es importante, puedes ordenar manualmente las páginas dentro de las secciones. Esto es crítico para documentación de incorporación o procedimientos donde el orden de lectura importa.

Un Editor que No Se Interpone en Tu Camino

Viene con un editor Markdown integrado con vista previa en vivo. Soporta tablas, listas de tareas, notas al pie e incluso diagramas Mermaid con fórmulas matemáticas KaTeX. Hay autocompletado para enlaces internos: comienza a escribir el nombre de otra página y el wiki inserta automáticamente el enlace correcto.

Enlaces Inteligentes

El sistema rastrea los enlaces entrantes. En cada página, puedes ver qué la referencia. Si renombras o mueves una página, LeafWiki puede actualizar automáticamente los enlaces en otros documentos (esta función necesita habilitarse con un flag --enable-link-refactor).

Respaldo para los Paranoicos

Más allá de simplemente copiar la carpeta de datos, las versiones recientes añadieron soporte experimental de respaldo Git. El wiki empujará automáticamente los cambios a tu repositorio remoto según una programación.

Para Quién No Es

Déjame ser claro desde el principio: esto no es un reemplazo de Notion. No hay edición colaborativa en tiempo real donde veas los cursores de tus colegas. Tampoco flujos de trabajo complejos de aprobación de publicación. Si necesitas que diez personas editen simultáneamente el mismo párrafo — sigue buscando.

Además, LeafWiki aún no soporta control de acceso granular hasta ramas individuales del árbol. Los roles existen (admin, editor, lector), pero se aplican a todo el wiki.

Cómo Empezar

Si tienes Docker instalado, lanzarlo toma unos treinta segundos.

docker run -p 8080:8080 \
    -v ~/leafwiki-data:/app/data \
    ghcr.io/perber/leafwiki:latest \
    --jwt-secret=super-secret-key \
    --admin-password=your-password \
    --allow-insecure=true

El flag --allow-insecure=true es necesario si estás ejecutando el proyecto localmente sin HTTPS. Si planeas exponerlo externamente a través de Nginx u otro proxy, es mejor eliminar este flag.

Por cierto, para los entusiastas del minimalismo, hay un instalador listo para Linux que registra LeafWiki como un servicio del sistema:

sudo /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/perber/leafwiki/main/install.sh)"

Trabajando desde Dispositivos Móviles

La interfaz es responsiva. Editar texto desde un teléfono es un placer cuestionable, pero leer documentación sobre la marcha o corregir rápidamente un error tipográfico es perfectamente factible.

LeafWiki te conquista con su predecibilidad. Es ideal para:

• Un diario técnico personal o base de conocimientos.
• Documentación para un proyecto pequeño.
• Runbooks internos para administradores o ingenieros DevOps.

Si estás cansado de luchar contra motores de wiki pesados y solo quieres escribir Markdown que se organice prolijamente — prueba este proyecto. Actualmente tiene menos de mil estrellas en GitHub, pero definitivamente tiene el potencial de convertirse en "esa herramienta simple" que has estado buscando.