Skip to content

sebastian-gsz/obsidian-vault-kit

v1.2.0MIT

Plugin para trabajar con vaults locales de Obsidian: Markdown de Obsidian, Bases, Canvas, CLI de Obsidian, sincronización headless, extracción web con Defuddle, plantillas con Knap, y skills de autoría de vault (escritura de notas y glosario de definiciones con el plugin Note Definitions) y optimización de imágenes webp (estáticos con cwebp, screencasts animados a MP4). Dependencias CLI gestionadas con pnpm dentro del propio plugin.

code-block-fixer

Reparar notas de Obsidian con código mal pegado — bloques de código insertados línea a línea como código en línea (`` ``línea`` `` o **``línea``**) en lugar de fences ```python. Los agrupa en bloques de código reales preservando indentación, separando ejemplos y sin tocar los resaltados semánticos. Úsala cuando el usuario diga que una nota tiene código que se ve como texto en línea, backticks dobles rodeando código, bloques rotos, o pida reparar/formatear/limpiar el código de una nota de estudio.

defuddle

Extraer Markdown limpio de páginas HTML con la CLI de Defuddle. Úsala cuando el usuario quiera extraer el contenido de una web en Markdown sin publicidad, navegación ni ruido.

image-optimizer

Optimizar el multimedia de un vault de Obsidian — recomprimir imágenes webp estáticas sin pérdida visible (cwebp) y convertir screencasts webp animados a MP4 (ffmpeg) actualizando las referencias en las notas. Úsala cuando el usuario quiera reducir el peso del vault, optimizar/comprimir imágenes, liberar espacio antes de un push a GitHub, o mencione que sus capturas o grabaciones .webp pesan demasiado.

json-canvas

Crea y edita archivos JSON Canvas (.canvas) con nodos, edges, grupos y conexiones. Úsala cuando trabajes con archivos .canvas, crees canvas visuales, mapas mentales, diagramas de flujo, o cuando el usuario mencione archivos Canvas en Obsidian.

knap

Renderizar Markdown desde plantillas y datos estructurados con la CLI de Knap. Úsala cuando el usuario pida aplicar una plantilla Knap, convertir datos JSON o CSV en notas, generar Markdown por lotes o formatear la salida de Defuddle en una nota.

obsidian-bases

Crea y edita Obsidian Bases (archivos .base) con vistas, filtros, fórmulas y resúmenes. Úsalo cuando trabajes con archivos .base, crees vistas tipo base de datos de notas, o cuando el usuario mencione Bases, vistas de tabla, vistas de tarjetas, tableros kanban, filtros o fórmulas en Obsidian.

obsidian-cli

Interactúa con vaults de Obsidian usando el Obsidian CLI para leer, crear, buscar y administrar notas, tasks, properties y más. También permite desarrollar plugins y temas con comandos para recargar plugins, ejecutar JavaScript, capturar errores, tomar capturas de pantalla e inspeccionar el DOM. Usar cuando el usuario pida interactuar con su vault de Obsidian, administrar notas, buscar contenido del vault, realizar operaciones del vault desde la línea de comandos, o desarrollar y depurar plugins y temas de Obsidian.

obsidian-headless

Sincroniza y publica vaults de Obsidian desde la línea de comandos con Obsidian Headless (ob), sin la app de escritorio. Usar cuando el usuario quiera configurar o ejecutar Obsidian Sync u Obsidian Publish en un servidor, en CI o desde una terminal, o cambiar la configuración de Sync o Publish de un vault.

obsidian-markdown

Crea y edita Obsidian Flavored Markdown con wikilinks, embeds, callouts, properties y otras sintaxis específicas de Obsidian. Usar cuando se trabaja con archivos .md en Obsidian, o cuando el usuario menciona wikilinks, callouts, frontmatter, tags, embeds o notas de Obsidian.

sebastian-definitions-writing

How to create and maintain definition notes in Sebastian's Obsidian vault glossary at P:\.obsidian\sebastian\definitions — the ACTIVE dictionary consumed by the Note Definitions plugin (hover popovers in every note of the vault). Covers the exact frontmatter schema (def-type/version/id/status/category/contexto/date/tags/aliases), term naming rules (basename + aliases become matchable phrases), the atomic body template, the status lifecycle (estandar→consolidado→finalizado→obsoleto), duplicate-term collision checks, and the plugin mechanics (atomic parser, dash divider, autoPlurals, 150×150 popover). Use whenever the user asks to define a term, add a glossary entry, create/edit a definition, fix or consolidate a definition note, or says things like "añade la definición de X", "define X", "nueva entrada del glosario", "actualiza la definición", "esa definición está obsoleta" — or when creating any .md file inside sebastian/definitions/.

sebastian-vault-writing

How to write, edit, locate and retire notes in Sebastian's Obsidian vault (P:\.obsidian) exactly the way he works — hub/portal notes, kanban boards, cloud lab notes (def-lab lifecycle), school notes, AI-chat captures and agent-ops manuals, stubs, trash lifecycle, ^uhmN block anchors, barra.gif separators and his style fingerprints. Use whenever creating, editing, renaming or reviewing ANY note in the vault (EXCEPT sebastian/definitions/, which has its own atomic schema), adding tasks to a kanban board, documenting a cloud lab or an AI conversation, deciding where a new note belongs, or saving content "en obsidian" — even if the request is just "añade esto al vault", "crea la nota", "documenta esto", "apunta esto en el kanban" or "guarda esto".

setup

Verificar el tooling del que dependen las skills de este plugin — la CLI oficial de Obsidian, Node.js/pnpm, y los binarios enjaulados de defuddle y knap dentro del plugin. Úsala cuando la CLI de una skill falta o no funciona, cuando se pide configurar alguna de ellas, o antes del primer uso de defuddle, knap u obsidian-cli.