🔮 Obsidian, el vault que se convierte en memoria
Donde el mapa se convierte en una memoria que puedes abrir, recorrer y consultar con el agente. Una bóveda es solo una carpeta de archivos markdown, y precisamente por eso Claude Code puede leerlo todo sin fricciones. Cada término se define la primera vez que aparece.
🗄️ Qué es Obsidian y un "vault"
O Obsidian es una aplicación de notas gratuita. Su gran acierto no es un formato mágico: abre una carpeta de archivos de texto que ya está en tu disco y la presenta como un cuaderno conectado. Esta carpeta tiene un nombre propio: el vault.
🔰 ¿Eres nuevo aquí? Qué son «vault» y «markdown»
Un vault ("cofre") es simplemente una carpeta en tu computadora que Obsidian trata como una colección de notas. No hay ninguna base de datos oculta: es la carpeta que ya ves en el explorador de archivos.
Markdown es texto común con un marcado ligero: # Título, - lista, **negrito**. Cada nota es un archivo .md que se abre en cualquier editor.
¿Por qué esto importa tanto para nuestro caso? Porque un vault no es un archivo propietario y bloqueado. Es una carpeta de .md — así Claude Code lee, hace grep y edita todo igual que tú. La memoria del agente y tu cuaderno pasan a ser el mismo lugar.
✓ Vault = carpeta de texto
- ✓Archivos
.mdque se abren en cualquier editor. - ✓Vive en tu disco — funciona sin conexión.
- ✓Se puede versionar con git y el agente puede leerlo.
✗ Formato propietario
- ✗Base de datos binaria que solo abre una app.
- ✗Atado a la nube de alguien.
- ✗El agente no puede leer sin exportar.
🔑 Conceptos clave
🔗 Markdown y wikilinks [[...]]
Si cada nodo del grafo se convierte en un archivo, falta algo: ¿cómo enlazar una nota con otra? La respuesta es el wikilink — escribes el nombre de otra nota entre dobles corchetes, y Obsidian lo convierte en un enlace clicable. Es la forma más sencilla posible de decir "esto se conecta con aquello".
🔰 ¿Eres nuevo aquí? «wikilink» y «backlink»
Un wikilink es la escritura [[Nome da nota]] dentro de un archivo markdown: un acceso directo que apunta a otra nota del vault.
Un backlink es el camino de regreso: si la nota A escribe [[B]], Obsidian muestra automáticamente en B «↩ referenciada por A». Solo escribes el enlace de ida; el de vuelta aparece por sí solo.
# Hooks Hooks são ganchos que rodam em eventos do agente. Eles compartilham a [[Context Window]] da sessão e costumam aparecer perto de [[Subagents]]. ## Relações - usa --> [[Context Window]] - vizinho-de --> [[Subagents]]
↑ Una nota de nodo típica del vault: texto markdown + wikilinks [[Context Window]]. Cada relación del grafo se convierte en un enlace en el que puedes hacer clic, y la nota Context Window obtiene un backlink que apunta de vuelta a Hooks.
↑ Las flechas cian son los wikilinks de ida que escribes; la flecha verde discontinua es el backlink que Obsidian crea automáticamente. Es esta doble vía la que permite navegar por el vault en ambos sentidos.
🔑 Conceptos clave
🌐 El grafo de Obsidian (no es el mismo grafo)
Obsidian tiene una pantalla llamada graph view ("vista de grafo"): una burbuja de puntos y líneas, bonita de ver. Es tentador pensar que é el grafo de conocimiento de Graphify, pero no lo es. Solo dibuja los enlaces entre las notas markdown que existen en el vault.
La diferencia es sutil, pero importa. El grafo de conocimiento real (entidades, relaciones tipadas, comunidades, god nodes) está en graph.json que generó Graphify. La vista de grafo de Obsidian es una representación visual de ese grafo después de convertirse en notas: pierde los tipos de relaciones y solo queda "A se conecta con B".
⚠️ La advertencia honesta del video
Como advierte el propio autor: "no es exactamente un knowledge graph, es un montón de markdown conectado." La graph view ayuda a navegar y ver clústeres — pero la fuente de verdad, con toda su riqueza, sigue siendo el graph.json.
graph.json (Graphify)
- •Relaciones tipadas (usa, contiene, deriva de).
- •Comunidades y god nodes calculados.
- •Procedencia: de qué archivo provino cada cosa.
graph view (Obsidian)
- •Solo «A está vinculado con B» — enlace sin tipo.
- •Ideal para ver y haz clic en los clusters.
- •Es un diseño del vault, no la fuente.
🔑 Conceptos clave
🤝 Por qué Markdown encaja con Claude Code
Aquí está el encaje que hace funcionar todo el stack: markdown es texto sin formato. No hay capa binaria, no hay base de datos propietaria ni conversión. El mismo archivo .md que lees con gusto en Obsidian es exactamente lo que Claude Code abre, hace grep y edita.
Y los wikilinks no estorban al agente: lo ayudan. Cuando Claude Code lee una nota y encuentra [[Context Window]], tiene el nombre exacto de la siguiente nota que debe abrir. El enlace es legible para las personas e por máquina al mismo tiempo. Sin lock-in ni formatos secretos: la memoria queda en un formato que sobrevive a cualquier herramienta.
✓ Markdown (texto puro)
- ✓El agente lee directamente, sin exportar.
- ✓grep y la edición funcionan línea por línea.
- ✓Tú y la máquina leen el mismo archivo.
✗ Formato binario
- ✗Necesita una app específica para abrirse.
- ✗grep devuelve basura; el agente se bloquea.
- ✗Dependencia: rehén de una sola herramienta.
🔑 Conceptos clave
🧰 Plugins, canvas e infraestructura
Mucha gente elige este stack no solo por el markdown, sino por la infraestructura a su alrededor: una interfaz agradable, búsqueda, temas y cientos de extensiones. Dos nombres aparecen todo el tiempo: canvas e plugins — y conviene saber qué hace cada uno.
🔰 ¿Eres nuevo aquí? «canvas» y «plugin»
O Canvas es un lienzo infinito de Obsidian: arrastras notas, cuadros y flechas en un espacio visual, como en un mural. Graphify genera un archivo graph.canvas ya con las comunidades agrupadas y nombradas.
Un plugin es una extensión que añade funciones a Obsidian (búsqueda avanzada, tablas, kanban, etc.), como un complemento del navegador, pero para tu cuaderno.
vault/ ├── Context Window.md ← nota de nó (com [[wikilinks]]) ├── Hooks.md ├── Subagents.md ├── graph.canvas ← comunidades como grupos no Canvas └── .obsidian/ ← config, temas e plugins do vault
↑ La anatomía de un vault generado: las notas .md, o graph.canvas con los clústeres, y la carpeta .obsidian/ donde viven los temas y los plugins. Todo es texto y está en tu disco.
Canvas = mapa visual
Las comunidades de Graphify se convierten en grupos con nombre en un tablero que puedes recorrer con la vista.
Plugins = recursos adicionales
Búsqueda, tablas dinámicas, visualizaciones: conectas solo lo que necesitas, sin modificar las notas.
🔑 Conceptos clave
🌉 La conexión: de graph.json al vault
Ahora se encuentran ambos márgenes. De un lado, el graph.json — la fuente de verdad del grafo. Por otro lado, el vault — la memoria que abres y consulta el agente. El export Obsidian es el puente: lee el graph.json y escribe un archivo .md por nodo, con los wikilinks ya colocados.
Un detalle que cierra el ciclo: el vault es regenerado en cada exportación. La fuente de verdad nunca es el markdown: siempre es el graph.json. Si el grafo cambia, vuelves a exportarlo y el vault se actualiza. Por eso la Ruta 1 termina aquí: ya entiendes ambos márgenes e el puente entre ellas. La Trilha 2 cruza ese puente en la práctica.
↑ El puente de toda la Ruta 1 en una imagen: el graph.json (fuente) atraviesa el export y se convierte en un abanico de .md — el vault que consulta Claude Code. ¿Regeneraste el grafo? Vuelve a exportarlo y el vault se actualizará.
🔑 Conceptos clave
✋ Autorrecuperación (opcional, no bloquea): si la nota Hooks.md escribe [[Context Window]], lo que crea Obsidian por sí solo en la nota Context Window.md?
📌 Resumen del módulo
Siguiente: Ruta 2 · Paso a paso práctico
Fin de los fundamentos. Ahora instalas Graphify, eliges la fuente, generas el grafo y creas el vault de Obsidian en la práctica.