Índice de documentación

Documentación principal

Documentación para desarrolladores

  • Referencia de la API - Documentación pública sobre la API. Cubre la gestión de metadatos, el control de la navegación y las suscripciones a eventos para desarrolladores JavaScript/TypeScript.
  • Guía de temas - Guía para desarrolladores de temas. Incluye referencia de clases CSS, propiedades personalizadas y ejemplos de temas para los modos claro y oscuro.
  • Proceso de inicio - Secuencia de inicialización de plugins. Flujos de arranque en frío frente a arranque en caliente, resolución de caché de metadatos, limpieza diferida y canal de generación de contenidos. Incluye diagramas Mermaid.
  • Canalización de metadatos - Secuencia de reconstrucción de la caché, etapas de la canalización de proveedores y señales de finalización. Incluye diagramas Mermaid.
  • Arquitectura de almacenamiento - Guía de contenedores de almacenamiento (IndexedDB, almacenamiento local, caché de memoria, configuración). Patrones de flujo de datos y pautas de uso.
  • Arquitectura de renderizado - Jerarquía de componentes React, desplazamiento virtual con TanStack Virtual, optimizaciones de rendimiento y flujo de datos.
  • Orquestación del desplazamiento - Cómo garantiza el plugin un desplazamiento preciso cuando cambian las estructuras del árbol (visibilidad de las etiquetas, configuración, etc.)
  • Arquitectura de servicios - Capa de lógica empresarial: MetadataService, FileSystemOperations, ContentProviderRegistry. Patrones de inyección de dependencia y flujo de datos del servicio.

1 Instalación

  1. Instalar Obsidian - Descargar e instalar desde obsidian.md
  2. Activar los plugins de la comunidad - Ve a Ajustes → Plugins de la comunidad → Activar los plugins de la comunidad
  3. Instalar Notebook Navigator - Haga clic en "Examinar" → Busque "Notebook Navigator" → Instalar
  4. Instale Style Settings (opcional) - Para personalizar los colores y la apariencia, instale el plugin Style Settings buscando "Style Settings" en Community plugins

2 Primeros pasos

Aquí tienes el tutorial oficial para aprender y dominar Notebook Navigator:

Mastering Notebook Navigator

El vídeo tiene subtítulos en 21 idiomas.


3 Seguridad y calidad

Notebook Navigator se comprueba con TypeScript, ESLint con el plugin oficial Obsidian ESLint, Prettier, Vitest y una compilación de producción antes de fusionar los cambios. La construcción debe completar con cero errores y cero advertencias.

Las comprobaciones de seguridad se ejecutan a través de CodeQL, con el historial de análisis en las ejecuciones de flujo de trabajo de CodeQL, y la OpenSSF Scorecard. El estado actual se muestra en las insignias de la parte superior de esta página.

Notebook Navigator se ejecuta localmente, pero algunas funciones realizan peticiones HTTP documentadas para actualizaciones, descargas y contenido remoto. Consulte la sección 10 - Divulgación de redes y diagnósticos para ver la lista completa.


Índice


4 Atajos de teclado

Clave Acción
↑/↓ Desplazarse hacia arriba/abajo en el panel actual
En el panel de navegación: contraer o ir al « » principal En el panel de lista: cambiar al panel de navegación
En el panel de navegación: expandir o cambiar al panel de lista En el panel de lista: cambiar al editor
Pestaña En el panel de navegación: cambiar al panel de lista En el panel de lista: cambiar al editor En el campo de búsqueda: cambiar al panel de lista
Mayús+Tab En el panel de lista: cambiar al panel de navegación En el campo de búsqueda: cambiar al panel de navegación
Intro (macOS) F2 (Windows/Linux) Renombrar un elemento directamente en el panel de navegación o en el panel de lista
Intro En el panel de navegación: abrir la nota de la carpeta en Windows/Linux de forma predeterminada (cuando esté habilitada) En el panel de lista: abrir el archivo seleccionado en todos los sistemas (cuando esté habilitada) En el campo de búsqueda: cambiar al panel de lista
Esc En el campo de búsqueda: cerrar la búsqueda y centrar el foco en el panel de lista
Re Pág/Av Pág Desplazarse hacia arriba/abajo en el panel de navegación y en el panel de lista
Inicio/Fin Ir al primer/último elemento del panel actual
Suprimir Retroceso Eliminar el elemento seleccionado
Cmd/Ctrl+A Seleccionar todas las notas de la carpeta actual
Cmd/Ctrl+clic Alternar selección de notas
Mayús+clic Seleccionar un rango de notas
Mayús+Inicio/Fin Seleccionar desde la posición actual hasta el primer/último elemento
Mayús + ↑/↓ Ampliar la selección hacia arriba/abajo
Cmd/Ctrl+↑/↓ Reordenar los archivos seleccionados hacia arriba o hacia abajo en el modo de ordenación manual

Nota: Todos los atajos de teclado pueden personalizarse. Consulte la sección 7 - Teclas de acceso rápido personalizadas para obtener más información sobre cómo añadir navegación estilo VIM (h,j,k,l), teclas alternativas y combinaciones de modificadores.


5 Ajustes sincronizados y locales

Muchos ajustes de Notebook Navigator muestran un conmutador de sincronización: un icono en forma de nube que alterna entre "Activar sincronización" y "Desactivar sincronización". Esto controla dónde se almacena cada ajuste y si se comparte entre dispositivos.

5.1 Cómo funciona la sincronización

Los plugins Obsidian almacenan su configuración en data.json, ubicado en .obsidian/plugins/notebook-navigator/data.json dentro de su carpeta vault. Cuando se utiliza un servicio de sincronización - como Obsidian Sync, iCloud, GitHub, Dropbox o Google Drive - este archivo se sincroniza a través de todos sus dispositivos junto con el resto de su bóveda. Cualquier configuración guardada en data.json se propagará a cada dispositivo que sincronice el almacén.

Screenshot 2026-02-18 at 22 58 05

Cuando la sincronización está activada (por defecto) para un ajuste, el valor se guarda en data.json y se sincroniza con todos los dispositivos a través de tu servicio de sincronización.

Screenshot 2026-02-18 at 22 58 14

Cuando se desactiva la sincronización de un ajuste, el valor se guarda en el almacenamiento local de Obsidian. El almacenamiento local es específico del dispositivo y no está incluido en la sincronización de la bóveda. El ajuste tendrá su propio valor independiente en cada dispositivo. Al desactivar la sincronización de un ajuste, el valor actual se copia en el almacenamiento local del dispositivo actual y el valor se elimina de data.json para evitar que anule los valores locales de otros dispositivos.

Si no utilizas un servicio de sincronización, esta opción no tiene ningún efecto práctico, ya que data.json sólo se almacena localmente.


6 Búsqueda

Notebook Navigator tiene dos modos de búsqueda: búsqueda por filtro y Omnisearch. Cambie entre ellos con las teclas de flecha arriba/abajo o haciendo clic en el icono de búsqueda. Combine nombres de archivo, propiedades, etiquetas, fechas y filtros en una sola consulta (por ejemplo, meeting .status=active #work @thisweek).

6.1 Filtrar la búsqueda

Filtra los archivos por nombre, etiquetas, propiedades, fechas, carpetas, extensiones y tareas dentro de la carpeta y subcarpetas actuales. Modo de búsqueda por defecto.

Nombres de archivos

  • word - Coincidir notas con "palabra" en el nombre del archivo
  • word1 word2 - Exigir que cada palabra coincida con el nombre del archivo
  • -word - Excluir notas con "word" en el nombre del archivo

Etiquetas

  • #tag - Incluir notas con etiqueta (también coincide con etiquetas anidadas como #tag/subtag)
  • # - Incluir sólo notas etiquetadas
  • -#tag - Excluir notas con etiqueta
  • -# - Incluir sólo notas no etiquetadas
  • #tag1 #tag2 - Coincidencia de ambas etiquetas (AND implícito)
  • #tag1 AND #tag2 - Coincidencia de ambas etiquetas (AND explícito)
  • #tag1 OR #tag2 - Coincidir con cualquiera de las etiquetas
  • #a OR #b AND #c - AND tiene mayor precedencia: coincide con #a, o con ambos #b y #c
  • Cmd/Ctrl+Clic en una etiqueta para añadir con AND. Cmd/Ctrl+Mayús+Clic para añadir con OR

Propiedades

  • .key - Incluir notas con la clave de propiedad
  • .key=value - Incluir notas cuando el valor de la propiedad contenga value
  • ."Reading Status" - Clave de propiedad con espacio en blanco (comillas dobles)
  • ."Reading Status"="In Progress" - Las claves y valores con espacios en blanco deben ir entre comillas dobles
  • -.key - Excluir notas con clave de propiedad
  • -.key=value - Excluir las notas en las que el valor de la propiedad contenga value
  • Cmd/Ctrl+Clic en una propiedad para añadir con AND. Cmd/Ctrl+Mayús+Clic para añadir con OR

Filtros

  • has:task - Incluir notas con las tareas pendientes
  • -has:task - Excluir notas con tareas pendientes
  • folder:meetings - Incluir notas cuando el nombre de una carpeta contenga meetings
  • folder:/work/meetings - Incluir notas sólo en work/meetings (no en subcarpetas)
  • folder:/ - Incluir notas sólo en la raíz de la bóveda
  • -folder:archive - Excluir notas cuyo nombre de carpeta contenga archive
  • -folder:/archive - Excluir notas sólo en archive (no en subcarpetas)
  • ext:md - Incluir notas con extensión md (ext:.md también es compatible)
  • -ext:pdf - Excluir notas con extensión pdf
  • Combinar con etiquetas, nombres y fechas (por ejemplo, folder:/work/meetings ext:md @thisweek)

Fechas

  • @today - Emparejar notas de hoy utilizando el campo de fecha por defecto
  • @yesterday, @last7d, @last30d, @thisweek, @thismonth - Intervalos de fechas relativos
  • @2026-02-07 - Coincidir un solo día (también admite @20260207)
  • @2026 - Coincidir con un año natural
  • @2026-02 o @202602 - Coincidir con un mes natural
  • @2026-W05 o @2026W05 - Coincidir con una semana ISO
  • @2026-Q2 o @2026Q2 - Coincidir con un trimestre natural
  • @13/02/2026 - Formatos numéricos con separadores (@07022026 sigue su configuración regional en caso de ambigüedad)
  • @2026-02-01..2026-02-07 - Coincidir con un intervalo de días inclusivo (se admiten extremos abiertos)
  • @c:... o @m:... - Fecha de creación o modificación del destino
  • -@... - Excluir una coincidencia de fecha

El campo de fecha predeterminado sigue el orden de clasificación actual. Al ordenar por nombre, el campo de fecha se configura en Ajustes → Notas → Fecha → Al ordenar por nombre.

Comportamiento Y/O

AND y OR funcionan en consultas de sólo etiqueta/propiedad (consultas que sólo contienen filtros #tag, -#tag, #, -#, .key, -.key, .key=value o -.key=value ). Si la consulta también incluye nombres, fechas, filtros de tareas, filtros de carpetas o filtros de extensiones, AND y OR se comparan como palabras de nombre de archivo.

  • Consulta del operador: #work OR .status=started
  • Consulta mixta: #work OR ext:md (OR se encuentra en los nombres de archivo)

6.2 Omnisearch

Búsqueda de texto completo en el almacén, filtrada a la carpeta actual, subcarpetas o etiquetas seleccionadas. Requiere el complemento Omnisearch. Si Omnisearch no está instalado, la búsqueda vuelve al filtro de búsqueda.

Las vistas previas de las notas muestran extractos de los resultados de Omnisearch en lugar del texto de vista previa predeterminado.

Limitaciones conocidas

  • Rendimiento: puede ser lento cuando se buscan menos de 3 caracteres en almacenes grandes
  • Filtros de ruta: el ámbito de la carpeta solo se envía a Omnisearch en el caso de las rutas ASCII simples. El resto de rutas se filtran una vez que Omnisearch ha devuelto los resultados.
  • Resultados limitados - Omnisearch busca en todo el almacén y devuelve un número limitado de resultados antes de filtrar, por lo que es posible que no aparezcan archivos relevantes de la carpeta actual si existen muchas coincidencias en otros lugares
  • Texto de vista previa: las vistas previas de las notas se sustituyen por extractos de los resultados de Omnisearch, que pueden no mostrar el resalte de coincidencia de búsqueda real si aparece en otra parte del archivo

7 Teclas de acceso rápido personalizadas

Edite .obsidian/plugins/notebook-navigator/data.json para personalizar las teclas de acceso rápido de Notebook Navigator. Abra el archivo y localice la sección keyboardShortcuts. Cada entrada asigna una acción a una o más combinaciones de teclas:

"pane:move-up": [ { "key": "ArrowUp", "modifiers": [] }, { "key": "K", "modifiers": [] } ]

Añada varios enlaces por acción para admitir claves alternativas, como en el ejemplo anterior de ArrowUp y K. Combine modificadores en una entrada enumerando cada valor, por ejemplo "modifiers": ["Mod", "Shift"]. Secuencias de teclado como gg o dd no son compatibles. Recarga Obsidian después de editar el archivo.

7.1 Modificadores

Modificador Tecla
Mod Cmd (macOS) / Ctrl (Win/Linux)
Alt Alt / Opción
Shift Mayúsculas
Ctrl Control (prefiera Mod para multiplataforma)

7.2 Acciones disponibles

Acción Tecla(s) predeterminada(s)
pane:move-up Flecha arriba
pane:move-down Flecha abajo
pane:page-up Re Pág
pane:page-down Avanzar página
pane:home Inicio
pane:end Fin
pane:rename Intro (macOS), F2 (Windows/Linux)
pane:delete-selected Suprimir, Retroceso
navigation:collapse-or-parent Flecha a la izquierda
navigation:expand-or-focus-list Flecha derecha
navigation:focus-list Tabulador
list:focus-navigation Flecha izquierda, Mayús+Tab
list:focus-editor Flecha derecha, Tab
list:select-all Mod+A
list:extend-selection-up Mayús + Flecha arriba
list:extend-selection-down Mayús+Flecha abajo
list:manual-sort-up Mod+Flecha arriba
list:manual-sort-down Mod+Flecha abajo
list:range-to-start Mayús+Inicio
list:range-to-end Mayús+Fin
search:focus-list Tab, Intro
search:focus-navigation Mayús+Tab
search:close Esc

8 Comandos

Establece teclas de acceso rápido personalizadas para estos comandos en la configuración de teclas de acceso rápido de Obsidian:

Vista y navegación

  • Notebook Navigator: Open Abre el Navegador de blocs de notas en la barra lateral izquierda. Si ya está abierto, desplaza el foco del teclado al panel de la lista. Sugerencia: Vincular a un atajo de teclado como Cmd/Ctrl+Shift+E para mover el foco del teclado al panel de la lista - esto es esencial para la navegación completa del teclado
  • Notebook Navigator: Toggle left sidebar Activa la barra lateral izquierda. Al abrirlo, establece la vista de la barra lateral izquierda en Notebook Navigator (a diferencia del comando "Alternar barra lateral izquierda" de Obsidian, que restaura la vista anterior de la barra lateral izquierda)
  • Notebook Navigator: Open homepage Abre la vista de Notebook Navigator y carga el objetivo de página de inicio configurado en ajustes
  • Notebook Navigator: Select vault profile Abre un modal para cambiar entre perfiles de cámara acorazada
  • Notebook Navigator: Reveal file Muestra el archivo actual en el navegador. Despliega las carpetas principales y se desplaza hasta el archivo. Este comando es útil si tiene desactivada la opción Auto-reveal active note y desea mostrar las notas manualmente. Sugerencia: Vincular a una tecla de acceso directo como Cmd/Ctrl+Shift+R para cambiar rápidamente la carpeta o etiqueta seleccionada al archivo actual
  • Notebook Navigator: Open all files Abre todas las notas de la carpeta o etiqueta actualmente seleccionada. Al abrir 15 o más archivos, muestra un diálogo de confirmación
  • Notebook Navigator: Navigate to folder Diálogo de búsqueda para saltar a cualquier carpeta
  • Notebook Navigator: Navigate to tag Diálogo de búsqueda para saltar a cualquier etiqueta
  • Notebook Navigator: Navigate to property Diálogo de búsqueda para saltar a cualquier clave o valor de propiedad
  • Notebook Navigator: Navigate back Se desplaza a la selección anterior de carpetas, etiquetas o propiedades en el historial del navegador
  • Notebook Navigator: Navigate forward Se desplaza a la siguiente carpeta, etiqueta o propiedad seleccionada en el historial del navegador
  • Notebook Navigator: Add to shortcuts Añade o elimina el archivo, carpeta, etiqueta o propiedad actual de los accesos directos
  • Notebook Navigator: Open shortcut 1-9 Abre el acceso directo por su posición en la lista de accesos directos
  • Notebook Navigator: Search Abre el campo de búsqueda rápida o lo centra si ya está abierto. La búsqueda persiste entre sesiones. Sugerencia: Vincular a una tecla de acceso directo como Cmd/Ctrl+Shift+S para el filtrado rápido de archivos
  • Notebook Navigator: Search whole vault Selecciona la carpeta raíz del almacén y abre la búsqueda incluyendo las subcarpetas (requiere que esté activada la opción « Show root folder »)

Selección

  • Notebook Navigator: Select next file Mueve la selección al archivo siguiente en la carpeta actual o en la vista de etiquetas. Respeta el orden de clasificación personalizado. Sugerencia: Vincular a una tecla de acceso directo como Option+Cmd+Right para ir rápidamente al siguiente archivo de la lista
  • Notebook Navigator: Select previous file Mueve la selección al archivo anterior en la carpeta actual o en la vista de etiquetas. Respeta el orden de clasificación personalizado. Sugerencia: Vincular a una tecla de acceso directo como Option+Cmd+Left para ir rápidamente al archivo anterior en la lista

Diseño y presentación

  • Notebook Navigator: Toggle dual pane layout Conmutar el diseño de uno o dos paneles (escritorio). Sugerencia: Vincular a una tecla de acceso directo como Cmd/Ctrl+Shift+A para cambiar rápidamente entre el diseño de panel único y doble
  • Notebook Navigator: Toggle dual pane orientation Cambia la orientación del panel doble entre horizontal y vertical
  • Notebook Navigator: Toggle descendants Alternar la visualización de notas de subcarpetas / descendientes para carpetas y etiquetas. Sugerencia: Vincular a una tecla de acceso directo como Cmd/Ctrl+Shift+D para alternar rápidamente la visualización de notas de subcarpetas / descendientes
  • Notebook Navigator: Toggle hidden folders, tags, and notes Mostrar u ocultar carpetas ocultas, etiquetas y notas
  • Notebook Navigator: Toggle tag sort order Alternar entre la ordenación de etiquetas por orden alfabético y por frecuencia
  • Notebook Navigator: Toggle tags by selection Limitar las etiquetas a las que se encuentran en las notas de la carpeta o propiedad seleccionada
  • Notebook Navigator: Toggle properties by selection Limitar las propiedades a las que se encuentran en las notas de la carpeta o etiqueta seleccionada
  • Notebook Navigator: Toggle compact mode Cambiar el modo de lista entre estándar y compacto
  • Notebook Navigator: Toggle pinned section Mostrar u ocultar notas ancladas en el panel de listas
  • Notebook Navigator: Collapse / expand all items Contraer o expandir todos los elementos en función del estado actual. Cuando Keep selected item expanded está activado (por defecto activado), todas las carpetas excepto la actual se contraerán. Esto es útil para mantener el árbol de navegación ordenado al buscar documentos
  • Notebook Navigator: Collapse / expand selected item Contraer o expandir el elemento de navegación seleccionado

Calendario

  • Notebook Navigator: Toggle calendar Activa o desactiva el calendario. Sugerencia: Vincular a un atajo de teclado como Cmd/Ctrl+Shift+C para mostrar rápidamente el calendario
  • Notebook Navigator: Open daily note Abre la nota diaria de hoy en función de la configuración de la agenda. Crea la nota si no existe
  • Notebook Navigator: Open weekly note Abre la nota semanal actual. Crea la nota si no existe
  • Notebook Navigator: Open monthly note Abre la nota mensual actual. Crea la nota si no existe
  • Notebook Navigator: Open quarterly note Abre la nota trimestral actual. Crea la nota si no existe
  • Notebook Navigator: Open yearly note Abre la nota anual actual. Crea la nota si no existe

Operaciones de archivo

Importante: Obsidian no tiene contexto de "carpeta o etiqueta actual", por lo que al crear notas en Obsidian por defecto se crean en la carpeta raíz, en la misma carpeta que el archivo actual, o en una carpeta específica. Cuando trabajes con Notebook Navigator siempre querrás crear nuevas notas en la carpeta o etiqueta actualmente seleccionada, así que lo primero que deberías hacer es enlazar Cmd/Ctrl+N a Notebook Navigator: Create new note para que las nuevas notas se creen siempre en la carpeta o etiqueta actualmente seleccionada. Lo mismo se aplica a mover y borrar archivos. Esta es la razón por la que debes utilizar estos comandos en lugar de los comandos integrados de Obsidian cuando utilices el Notebook Navigator.

  • Notebook Navigator: Create new note Crear nota en la carpeta actualmente seleccionada. Sugerencia: Vincular Cmd/Ctrl+N a este comando (desvincular del comando por defecto de Obsidian "Crear nueva nota" primero)
  • Notebook Navigator: Create new note from template Crear una nota a partir de una plantilla de la carpeta seleccionada (requiere Templater)
  • Notebook Navigator: Move files Mueve los archivos seleccionados a otra carpeta. Selecciona el siguiente archivo de la carpeta actual
  • Notebook Navigator: Merge notes Crear una nota a partir de las notas Markdown seleccionadas en el orden actual de la lista
  • Notebook Navigator: Convert to folder note Cree una carpeta que coincida con el nombre del archivo y mueva el archivo dentro como la nota de la carpeta
  • Notebook Navigator: Set as folder note Cambiar el nombre del archivo activo a su nombre de nota de carpeta
  • Notebook Navigator: Detach folder note Separar la nota de carpeta de la carpeta seleccionada y cambiarle el nombre
  • Notebook Navigator: Pin all folder notes Fijar todas las notas de las carpetas en todas las carpetas. El comando solo es visible cuando las notas de las carpetas están activadas.
  • Notebook Navigator: Delete files Elimina los archivos seleccionados. Selecciona el siguiente archivo de la carpeta actual

Operaciones de etiquetado

  • Notebook Navigator: Add tag to selected files Diálogo para añadir etiquetas a los archivos seleccionados. Admite la creación de nuevas etiquetas
  • Notebook Navigator: Set property on selected files Diálogo para establecer propiedades en los archivos seleccionados
  • Notebook Navigator: Remove tag from selected files Diálogo para eliminar una etiqueta específica. Se elimina inmediatamente si sólo hay una etiqueta
  • Notebook Navigator: Remove all tags from selected files Borrar todas las etiquetas de los archivos seleccionados con confirmación

Mantenimiento

  • Notebook Navigator: Rebuild cache Reconstruye la caché local de Notebook Navigator. Utilícelo si le faltan etiquetas, previsualizaciones incorrectas o le faltan imágenes de características

8.1 Identificación de comandos

ID del comando Nombre del comando
notebook-navigator:open Navegador de cuadernos: Abrir
notebook-navigator:toggle-left-sidebar Navegador de cuadernos: Alternar barra lateral izquierda
notebook-navigator:open-homepage Navegador de cuadernos: Abrir página de inicio
notebook-navigator:select-profile Navegador de cuadernos: Seleccionar perfil de almacén
notebook-navigator:select-profile-1 Navegador de cuadernos: Seleccionar perfil de almacén 1
notebook-navigator:select-profile-2 Navegador del cuaderno: Seleccionar perfil de almacén 2
notebook-navigator:select-profile-3 Navegador de cuadernos: Seleccionar perfil de almacén 3
notebook-navigator:reveal-file Navegador de cuadernos: Mostrar archivo
notebook-navigator:open-all-files Navegador de cuadernos: Abrir todos los archivos
notebook-navigator:navigate-to-folder Navegador de cuadernos: Ir a la carpeta
notebook-navigator:navigate-to-tag Navegador de cuadernos: Navegar a una etiqueta
notebook-navigator:navigate-to-property Navegador de cuadernos: Ir a la propiedad
notebook-navigator:navigate-back Navegador de cuadernos: Volver
notebook-navigator:navigate-forward Navegador de cuadernos: Avanzar
notebook-navigator:add-shortcut Navegador de cuadernos: Añadir a accesos directos
notebook-navigator:open-shortcut-1 Navegador de cuadernos: Abrir acceso directo 1
notebook-navigator:open-shortcut-2 Navegador del cuaderno: Abrir acceso directo 2
notebook-navigator:open-shortcut-3 Navegador de cuadernos: Abrir acceso directo 3
notebook-navigator:open-shortcut-4 Navegador de cuadernos: Abrir acceso directo 4
notebook-navigator:open-shortcut-5 Navegador de cuadernos: Abrir acceso directo 5
notebook-navigator:open-shortcut-6 Navegador de cuadernos: Abrir acceso directo 6
notebook-navigator:open-shortcut-7 Navegador de cuadernos: Abrir acceso directo 7
notebook-navigator:open-shortcut-8 Navegador de cuadernos: Abrir acceso directo 8
notebook-navigator:open-shortcut-9 Navegador de cuadernos: Abrir acceso directo 9
notebook-navigator:search Navegador de cuadernos: Buscar
notebook-navigator:search-vault Navegador de cuadernos: Buscar en todo el almacén
notebook-navigator:toggle-dual-pane Navegador de cuadernos: Alternar entre el diseño de doble panel
notebook-navigator:toggle-dual-pane-orientation Navegador de cuadernos: Alternar la orientación del panel doble
notebook-navigator:toggle-calendar Navegador de cuadernos: Activar/desactivar el calendario
notebook-navigator:open-daily-note Navegador de cuadernos: Abrir nota diaria
notebook-navigator:open-weekly-note Navegador de cuadernos: Abrir nota semanal
notebook-navigator:open-monthly-note Navegador del cuaderno: Abrir nota mensual
notebook-navigator:open-quarterly-note Navegador del cuaderno: Abrir nota trimestral
notebook-navigator:open-yearly-note Navegador del cuaderno: Abrir nota anual
notebook-navigator:toggle-descendants Navegador de cuadernos: Alternar descendientes
notebook-navigator:toggle-hidden Navegador de cuadernos: Alternar entre carpetas, etiquetas y notas ocultas
notebook-navigator:toggle-tag-sort Navegador de cuadernos: Alternar el orden de clasificación de etiquetas
notebook-navigator:toggle-tags-by-selection Navegador de cuadernos: Mostrar o ocultar etiquetas según la selección
notebook-navigator:toggle-properties-by-selection Navegador de cuadernos: Mostrar o ocultar propiedades según la selección
notebook-navigator:toggle-compact-mode Navegador de cuadernos: Activar o desactivar el modo compacto
notebook-navigator:toggle-pinned-section Navegador de cuadernos: Mostrar o ocultar la sección anclada
notebook-navigator:collapse-expand Navegador de cuadernos: Contraer/expandir todos los elementos
notebook-navigator:collapse-expand-selected-item Navegador de cuadernos: Contraer/expandir el elemento seleccionado
notebook-navigator:new-note Navegador de cuadernos: Crear una nueva nota
notebook-navigator:new-note-from-template Navegador del cuaderno: Crear una nueva nota a partir de una plantilla
notebook-navigator:move-files Navegador de cuadernos: Mover archivos
notebook-navigator:merge-notes Navegador de cuadernos: Combinar notas
notebook-navigator:select-next-file Navegador de cuadernos: Seleccionar el siguiente archivo
notebook-navigator:select-previous-file Navegador de cuadernos: Seleccionar el archivo anterior
notebook-navigator:convert-to-folder-note Navegador de cuadernos: Convertir en nota de carpeta
notebook-navigator:set-as-folder-note Navegador del cuaderno: Establecer como nota de carpeta
notebook-navigator:detach-folder-note Navegador de cuadernos: Desvincular nota de carpeta
notebook-navigator:pin-all-folder-notes Navegador del cuaderno: Anclar todas las notas de carpeta
notebook-navigator:delete-files Navegador de cuadernos: Eliminar archivos
notebook-navigator:add-tag Navegador de cuadernos: Añadir etiqueta a los archivos seleccionados
notebook-navigator:set-property Navegador de cuadernos: Establecer propiedad en los archivos seleccionados
notebook-navigator:remove-tag Navegador de cuadernos: Eliminar etiqueta de los archivos seleccionados
notebook-navigator:remove-all-tags Navegador de cuadernos: Eliminar todas las etiquetas de los archivos seleccionados
notebook-navigator:rebuild-cache Navegador de cuadernos: Reconstruir caché

9 Características

9.1 Interfaz

  • Diseño de doble panel: panel de navegación (carpetas/etiquetas/propiedades) y panel de lista (archivos)
  • Modo de panel único: vistas de navegación y lista con transiciones animadas
  • Paneles redimensionables - Orientación horizontal o vertical dividida
  • Zoom independiente de la interfaz de usuario - Escala el navegador del bloc de notas sin cambiar el zoom de Obsidian
  • Vista de inicio - Primero la navegación o primero la lista
  • Soporte multilingüe - 21 idiomas con soporte de diseño RTL
  • Conjunto de iconos de interfaz: iconos de interfaz de usuario personalizables en todo el plugin

9.2 Navegación

  • Perfiles de bóveda: múltiples vistas filtradas con carpetas/etiquetas/notas ocultas por perfil, visibilidad de archivos, banner y accesos directos
  • Accesos directos: notas, carpetas, etiquetas, propiedades y búsquedas guardadas, con la posibilidad de fijarlas y reordenarlas
  • Notas/archivos recientes: sección de elementos recientes almacenados por perfil de almacén, opcionalmente anclados con accesos directos
  • Calendario: calendario de notas diarias con selección de días, previsualización de imágenes y división vertical
  • Árbol de carpetas - Navegación desplegable con ordenación manual de la carpeta raíz
  • Árbol de etiquetas - Etiquetas jerárquicas con ordenación configurable de la etiqueta raíz
  • Explorador de propiedades: examine las propiedades de los archivos organizadas por clave y valor con recuento de archivos, colores personalizados, iconos y función de arrastrar y soltar
  • Revelación automática del archivo activo - Ampliación de carpetas y desplazamiento hasta la selección
  • Teclado y comandos - Teclas de acceso rápido configurables, comandos de retroceso/avance en el historial de selección, comandos de archivo siguiente/anterior, comandos de acceso directo de apertura 1-9

9.3 Organización

  • Anclar notas: mantenga las notas importantes en la parte superior de las carpetas y etiquetas
  • Notas decarpeta - Establecer/eliminar notas de carpeta, anclar notas de carpeta, opción de abrir en nueva pestaña
  • Operaciones con etiquetas - Añadir/eliminar/borrar etiquetas, renombrar/borrar etiquetas, crear nota en etiqueta, arrastrar y soltar jerarquía de etiquetas
  • Ordenacióny agrupación personalizadas: anulación de los ajustes de ordenación/agrupación por carpeta o etiqueta
  • Apariencias por carpeta/etiqueta - Filas de título, filas de vista previa, modo compacto, alternancia de descendientes
  • Contenido oculto: carpetas/etiquetas/notas/archivos ocultos con patrones, propiedades frontmatter y filtrado basado en etiquetas por perfil de almacén
  • Excluir carpetas de los elementos subordinados: omitir carpetas al recopilar notas de las subcarpetas, según el perfil del almacén; las carpetas excluidas siguen siendo visibles y muestran sus notas cuando se seleccionan
  • Sistema de colores e iconos: colores de carpeta/etiqueta/propiedad/archivo, paquetes de iconos, iconos emoji/Lucide, lectura/escritura de frontmatter, asignación de iconos por nombre de archivo y categoría de tipo de archivo
  • Advertencias sobre nombres - Advierte sobre caracteres prohibidos del sistema de archivos y caracteres que rompen los enlaces de Obsidian al nombrar archivos y carpetas

9.4 Visualización de archivos

  • Vista previa de notas - 1-5 líneas de vista previa con eliminación opcional de HTML
  • Miniaturas: imágenes destacadas y miniaturas generadas automáticamente para archivos PDF, SVG y de dibujo almacenados en la caché de metadatos
  • Imágenes externas - Descargas opcionales para imágenes externas y miniaturas de YouTube
  • Agrupación por fechas: agrupa las notas por Hoy, Ayer, 7 días anteriores, 30 días anteriores, meses y años cuando se ordenan por fecha
  • Compatibilidad con frontmatter - Lectura de nombres de notas y marcas de tiempo de los campos frontmatter
  • Metadatos de notas - Mostrar la fecha de modificación y las etiquetas en la lista de archivos
  • Propiedades personalizadas - Mostrar propiedades frontmatter o recuento de palabras en la lista de archivos con anulaciones por carpeta/etiqueta y colores personalizados
  • Visualización de la carpeta principal - Nombre e icono opcional de la carpeta principal en la lista de archivos
  • Modo compacto: visualización compacta cuando la vista previa, la fecha y las imágenes están desactivadas
  • Etiquetas en lasque se puede hacer clic: las etiquetas de la lista de archivos llevan directamente a esa etiqueta

9.5 Productividad

  • Búsqueda: filtre por nombre de archivo, etiquetas, propiedades, fechas, carpetas, extensiones y tareas con Y/O/exclusiones
  • Integración con Omnisearch - Búsqueda de texto completo a través de Omnisearch
  • Arrastrar y soltar - Movimientos de archivos, etiquetado, asignación de accesos directos, redistribución del árbol de etiquetas, carpetas con resorte
  • Menús contextuales - Crear notas/carpetas/lienzos/bases/dibujos y ejecutar acciones de archivo/etiqueta
  • Dibujos - Cree dibujos Excalidraw y Tldraw desde los menús de navegación y del panel de listas
  • Plantillas - Nueva nota de comandos de plantilla con el plugin Templater
  • Operaciones con archivos - Crear, renombrar, duplicar, mover, eliminar archivos y carpetas
  • Filtrado - Exclusiones de carpetas/etiquetas/notas/archivos con patrones y propiedades frontmatter

10 Divulgación de redes y diagnósticos

Notebook Navigator se ejecuta localmente, pero algunas funciones realizan peticiones HTTP desde Obsidian. El registro de depuración de inicio también puede escribir un archivo de diagnóstico local en su bóveda.

10.1 Comprobaciones de actualización de versiones (opcional)

  • Configuración: "Buscar nueva versión al iniciar"
  • Petición: https://api.github.com/repos/johansan/notebook-navigator/releases/latest
  • Frecuencia: Como máximo una vez cada 24 horas, al arrancar
  • Datos: Envía metadatos HTTP estándar; no incluye el contenido de la bóveda

10.2 descargas de paquetes de iconos (opcional)

  • Configuración: Activar un paquete de iconos en la pestaña Paquetes de iconos
  • Solicitudes: https://raw.githubusercontent.com/johansan/notebook-navigator/main/icon-assets/... (manifiesto, fuente, metadatos)
  • Almacenamiento: Almacenado localmente en IndexedDB

10.3 Imágenes externas, vídeos y miniaturas de YouTube

  • Imágenes de fondo (opcional): Controlado por el ajuste "Descargar imágenes externas". Descarga imágenes remotas y miniaturas de YouTube para imágenes de características y las almacena localmente en IndexedDB.
  • Modalidad de bienvenida (Primer lanzamiento): Carga una miniatura estática desde https://raw.githubusercontent.com/johansan/notebook-navigator/main/images/youtube-thumbnail.jpg.
  • Modalidad Novedades (Al actualizar / al abrir): Carga las imágenes de los banners de la versión desde https://raw.githubusercontent.com/johansan/notebook-navigator/main/images/version-banners/<id>.jpg para las notas de la versión que incluyen un banner.
  • Ventana modal «Novedades» (al actualizar / al abrirla): carga vídeos de lanzamientos desde https://raw.githubusercontent.com/johansan/notebook-navigator/main/images/version-banners/<id>.mp4 para las notas de lanzamiento que incluyen un vídeo.
  • Ventana modal «Novedades» (al abrir un vídeo de lanzamiento): abre los vídeos de lanzamiento desde https://cdn.jsdelivr.net/gh/johansan/notebook-navigator@main/images/version-banners/<id>.mp4 para que los navegadores puedan reproducirlos directamente.
  • Modalidad Novedades (al actualizar / al abrir): Carga las miniaturas de YouTube desde https://img.youtube.com/vi/<id>/... para las notas de la versión que incluyen un enlace a YouTube.

10.4 Archivos de depuración de inicio (Opcional)

  • Configuración: "Registro de depuración de inicio"
  • Almacenamiento: Escribe un archivo nn-debug-...md con fecha y hora en la raíz del almacén y se detiene una vez que se ha establecido el inicio. El archivo puede sincronizarse si la raíz del almacén está sincronizada.
  • Datos: Incluye tiempo de arranque, versión del plugin, versión mínima de Obsidian soportada, plataforma, recuentos de caché, recuentos de colas, estado de IndexedDB y errores de diagnóstico. No incluye el contenido de las notas, los nombres de las etiquetas, los valores de frontmatter ni una lista de los archivos del almacén.
  • Rutas e identificadores: La inicialización de inicio, los diagnósticos de PDF y los casos de error pueden incluir el identificador de aplicación/bóveda de Obsidian, las rutas de PDF relativas a la bóveda o los detalles de la pila de errores. Revise y redacte el archivo antes de compartirlo públicamente.
  • Cargar: Notebook Navigator no carga archivos de depuración. Sólo se comparten si los subes, adjuntas o sincronizas fuera del plugin.

10.5 Privacidad y tratamiento de datos

  • Notebook Navigator no envía contenido de notas, nombres de archivos, etiquetas o archivos de depuración a un servidor de Notebook Navigator.
  • Las solicitudes a GitHub, YouTube y cualquier host de imágenes externo se realizan directamente desde su dispositivo e incluyen metadatos HTTP estándar (dirección IP, agente de usuario y similares).
  • Los paquetes de iconos descargados y las imágenes se almacenan localmente (IndexedDB). Las notas/archivos recientes y el estado de la interfaz de usuario se almacenan localmente (Obsidian local storage).

historia de 12 estrellas

Star History Chart


12 Contacto

Notebook Navigator está construido y mantenido por Johan Sanneblad. Johan tiene un doctorado en Desarrollo de Software y ha trabajado en el desarrollo de la innovación para empresas como Apple, Electronic Arts, Google, Microsoft, Lego, SKF, Volvo Cars, Volvo Group y Yamaha.

No dude en conectar conmigo en LinkedIn.


13 ¿Preguntas o problemas?

Únete a nuestro Discord para asistencia y debates, o abre una incidencia en elrepositorio de GitHub.

No se aceptan solicitudes de incorporación de cambios (pull requests). Con la aparición de la programación agentiva, no es posible garantizar que el código enviado desde fuera cumpla con los estándares de calidad que mantiene el proyecto, por lo que cualquier solicitud de incorporación de cambios se cierra automáticamente. En su lugar, aporta tus ideas como solicitudes de nuevas funcionalidades: abre una incidencia. Consulta el archivo CONTRIBUTING.md para obtener más detalles.


14 Licencia

Este proyecto está licenciado bajo la GNU General Public License v3.0 - vea el archivo LICENSE para más detalles.