Importar vault de Obsidian

Subí un ZIP de tu vault y Orkestra lo convierte en un árbol de páginas Wiki al nivel de la organización, respetando la jerarquía de carpetas y reescribiendo los wikilinks internos a rutas de Orkestra.

Si lo que buscás es conectar el vault a un agente de IA sin migrar el contenido, mirá la guía Obsidian + MCP. Ese patrón es para lectura en vivo desde el agente; este importer es para migrar el contenido una vez al Wiki compartido del equipo.

Cómo exportar el vault

Obsidian no tiene un export nativo — el vault es una carpeta de archivos markdown. Solo hay que zipearla:

  1. Cerrá Obsidian (para que no haya escrituras en curso).
  2. Ubicá la carpeta del vault en el Finder/Explorador.
  3. Comprimila como ZIP:
    • macOS: clic derecho → Comprimir.
    • Windows: clic derecho → Enviar a → Carpeta comprimida.
    • Linux: zip -r vault.zip /ruta/al/vault.
  4. Tamaño máximo: 50 MB. Si tu vault es más grande, excluí carpetas pesadas (attachments/, imágenes) y re-zipeá. Orkestra no importa binarios igual.

Qué se importa

  • Archivos .md → páginas Wiki (scope ORGANIZATION, visibilidad PUBLIC).
  • Jerarquía de carpetas → relaciones padre-hijo en el árbol wiki. Cada carpeta crea una "página índice" para agrupar a sus hijas.
  • Frontmatter YAML — si la página tiene title: "...", ese valor override el nombre de archivo. El resto del frontmatter se preserva dentro del contenido de la página.
  • Wikilinks [[Página]] → se reescriben a [Página](/wiki/<slug>) si el destino existe en el vault.
  • Wikilinks con alias [[Página|texto visible]] → [texto visible](/wiki/<slug>).
  • Wikilinks rotos (destino no existe) → se convierten a texto plano y se cuentan en la preview.
  • Embeds ![[archivo.png]] → placeholder `[archivo.png (attachment not imported)]`. La referencia queda visible para que sepas qué falta.

Qué queda fuera de scope

  • Binarios (imágenes, PDFs, audio, cualquier cosa no-.md) — no se suben. Los embeds quedan como placeholders.
  • Carpeta .obsidian/ — se ignora silenciosamente (es la config de la app, no contenido).
  • Otros dotfiles (.DS_Store, .git/) — ignorados.
  • Plugins community (Dataview, Templater, Kanban, Canvas, Excalidraw) — los archivos especiales que generan (.canvas, .excalidraw) se ignoran. Las queries de Dataview quedan como código markdown inerte.
  • Tags (#tag) — se preservan literalmente en el texto pero no se mapean a Áreas ni a labels de Orkestra. El modelo WikiPage no tiene campo tags nativo.
  • Carpetas con más de 10 niveles de profundidad — las páginas dentro se aplanan al root del árbol wiki con un warning. Es un cap del motor de wiki de Orkestra para evitar ciclos.
  • Más de 2.000 páginas en total — el importer se detiene. Si tu vault es gigante, dividí por sección.
  • Sync bidireccional — no existe. El import es una foto puntual. Si seguís editando el vault después, los cambios no se reflejan en Orkestra (y viceversa).
  • Historial de versiones del archivo — se importa solo la versión actual. Orkestra arranca su propio historial de versiones desde ese punto.

Requisitos

  • El import requiere una organización activa. No se puede importar a un espacio personal.
  • Permisos de admin o de creador de wiki en la org.

Warnings vs ignores silenciosos

La preview avisa por: cantidad de wikilinks rotos, archivos que excedieron el depth cap, archivos no-markdown encontrados, fallas puntuales al leer un archivo. Dotfiles, plugins y binarios se ignoran sin mensaje.

Pasos en Orkestra

  1. Ir a Ajustes → Importar → Obsidian.
  2. Subir el ZIP del vault.
  3. Revisar en la preview: cantidad de páginas a crear, wikilinks rotos, archivos skipped por depth, advertencias.
  4. Ejecutar. Commit atómico.

Alternativa: leer el vault sin importar

Si no querés copiar el contenido al Wiki del equipo y preferís mantenerlo en tu vault local, podés conectarlo a tu agente de IA vía MCP. Ver Obsidian + MCP.

Recursos