Primero, ¿qué es org-roam?

Imagina las notas de toda la vida —una por tema— pero en vez de meterlas en carpetas, las enlazas entre sí. Escribes una nota sobre "deuda técnica" y, dentro, mencionas y enlazas a tu nota de "refactor" y a la de "tests". Cada nota es pequeña, atómica, sobre una idea. Y el valor no está en la carpeta donde la guardas, sino en con qué otras notas la conectas.

Eso es org-roam: un sistema de notas enlazadas dentro de org-mode (la idea viene del método zettelkasten, las fichas conectadas que usaba el sociólogo Niklas Luhmann para escribir decenas de libros). La gracia: no organizas por jerarquía —"esto va en la carpeta de trabajo, dentro de la subcarpeta de proyectos"— sino por relación. Una nota puede estar conectada a otras diez sin vivir "dentro" de ninguna.

¿El problema que resuelve? El clásico: guardas notas, y seis meses después no las encuentras porque no recuerdas en qué carpeta las metiste. Con enlaces, llegas a una nota desde cualquiera de sus vecinas. El conocimiento deja de ser un archivador y pasa a ser una red.

¿Y por qué un grafo?

Si tus notas son una red de cosas conectadas, hay una forma natural de verla: un grafo. Un dibujo donde:

• cada nota es un punto (un nodo), y
• cada enlace entre dos notas es una línea que las une.

De golpe, tu maraña de notas se vuelve un mapa. Y ese mapa dice cosas:

• Los racimos (grupos de nodos muy conectados entre sí) son tus temas fuertes, donde más has pensado.
• Los nodos con muchas líneas saliendo son tus ideas-eje, las que tocan todo lo demás.
• Los nodos sueltos, sin apenas conexiones, son notas huérfanas: o las enlazas con algo, o a lo mejor sobran.

Es literalmente ver la forma de lo que sabes. Por eso engancha tanto la primera vez: no es información nueva, es tu información, dibujada.

El salto: del mapa en papel al mapa vivo

Org-roam ya sabe pintar ese grafo de fábrica, pero te lo da como una imagen estática: una foto. Bonita, pero quieta. La miras y ya.

org-roam-ui es el salto a la versión viva. Abre el mismo mapa en tu navegador, pero interactivo (está hecho con una tecnología web de gráficos, D3.js, la de las visualizaciones que se mueven). Y ahí cambia todo:

• Zoom y arrastre: te acercas a un rincón, exploras un racimo, te alejas para ver el conjunto. Como un mapa de Google, pero de tus ideas.
• Click en un nodo = saltas a la nota. El grafo no es solo para mirar: es un menú de navegación. Ves un punto interesante, lo clicas, y estás editando esa nota en Emacs.
• Te sigue: a medida que abres notas en el editor, el grafo resalta el nodo donde estás y se centra en él. Caminas por tus notas y el mapa marca tu posición en tiempo real.
• Se mueve solo, con física: los nodos se reparten, se agrupan, respiran. Y con el tema oscuro de tu editor, da hasta gusto mirarlo.

¿Para qué sirve de verdad (más allá de lo bonito)?

Tres usos concretos, por si "es chulo" no te basta:

1. Descubrir conexiones que no sabías que tenías. Ves dos racimos unidos por un único hilo y piensas "anda, no sabía que esto tenía que ver con aquello". Esas sorpresas son oro: ideas nuevas salen de cruzar viejas.
2. Encontrar lo abandonado. Los nodos sueltos en la periferia son notas que empezaste y dejaste colgando. El grafo te las señala sin que las busques.
3. Navegar cuando no recuerdas el nombre. A veces no sabes cómo se llamaba una nota, pero sí "estaba cerca de la de arquitectura". En el mapa, vas a la zona y la encuentras por vecindad, no por nombre.

Cómo se enciende

Una vez instalado (un paquete y cuatro líneas de config), se lanza con un comando:

M-x org-roam-ui-mode

Se abre el grafo en el navegador y queda conectado en vivo con tu Emacs: abres una nota, el mapa te sigue; clicas un nodo, saltas a la nota. Cuando acabas, apagas el modo y el servidor se cierra. No molesta a nadie mientras no lo enciendes.

El cierre

Organizar por carpetas es decidir, para siempre, el único sitio donde vivirá cada idea. Organizar por enlaces es dejar que las ideas vivan donde de verdad viven: conectadas a otras. El grafo solo hace visible esa diferencia.

Si tienes notas en org-roam y nunca las has visto, enciende el grafo una vez. Probablemente reconozcas tu cabeza ahí dibujada —los temas en los que más has pensado, los cabos sueltos, los puentes inesperados— y entiendas, de un vistazo, por qué esto de enlazar notas tiene tanto tirón. No es un juguete. Es un espejo.

— doomguru