---

1 Instalação

1. Instalar a Obsidian - Faça o download e instale a partir de obsidian.md
2. Ativar plug-ins da comunidade - Vá para Settings → Community plugins → Ativar plug-ins da comunidade
3. Instalar o Notebook Navigator - Clique em "Browse" → Procure por "Notebook Navigator" → Instale
4. Instalar Style Settings (opcional) - Para personalizar as cores e a aparência, instale o plug-in Style Settings procurando por "Style Settings" em Plug-ins da comunidade

2 Primeiros passos

Aqui está o tutorial oficial para aprender e dominar o Notebook Navigator:

O vídeo tem legendas em 21 idiomas.

3 Segurança e qualidade

O Notebook Navigator é verificado com TypeScript, ESLint com o plug-in oficial Obsidian ESLint, Prettier, Vitest e uma compilação de produção antes que as alterações sejam mescladas. A compilação deve ser concluída com zero erros e zero avisos.

As verificações de segurança são executadas por meio do CodeQL, com histórico de varredura nas execuções do fluxo de trabalho do CodeQL e no OpenSSF Scorecard. O status atual é mostrado nos emblemas na parte superior desta página.

O Notebook Navigator é executado localmente, mas alguns recursos fazem solicitações HTTP documentadas para atualizações, downloads e conteúdo remoto. Consulte a seção 10 - Divulgação de rede e diagnóstico para obter a lista completa.

Tabela de conteúdo

• 4 Atalhos de teclado
• 5 Configurações sincronizadas e locais
• 6 Pesquisa
• 7 Teclas de atalho personalizadas
• 8 Comandos
• 9 Recursos
• 10 Divulgação de rede e diagnóstico
• 11 Star History
• 12 Contato
• 13 Perguntas ou problemas?
• 14 Licença

4 Atalhos de teclado

Chave	Ação
↑/↓	Navegar para cima/para baixo no painel atual
←	No painel de navegação: recolher ou ir para o pai No painel de lista: alternar para o painel de navegação
→	No painel de navegação: expandir ou alternar para o painel de lista No painel de lista: alternar para o editor
Tab	No painel de navegação: alternar para o painel de lista No painel de lista: alternar para o editor No campo de pesquisa: alternar para o painel de lista
Shift+Tab	No painel de lista: alternar para o painel de navegação No campo de pesquisa: alternar para o painel de navegação
Enter (macOS) F2 (Windows/Linux)	Renomear item diretamente no painel de navegação ou no painel de lista
Enter	No painel de navegação: abrir a nota da pasta no Windows/Linux por padrão (quando ativado) No painel de lista: abrir o arquivo selecionado em todos os sistemas (quando ativado) No campo de pesquisa: alternar para o painel de lista
Esc	No campo de pesquisa: fechar a pesquisa e focar no painel de lista
PageUp/PageDown	Rolar para cima/baixo no painel de navegação e no painel de lista
Home/End	Ir para o primeiro/último item no painel atual
Delete Backspace	Excluir o item selecionado
Cmd/Ctrl+A	Selecionar todas as notas na pasta atual
Cmd/Ctrl+Clique	Alternar a seleção de notas
Shift+Clique	Selecionar um intervalo de notas
Shift+Home/End	Selecionar da posição atual até o primeiro/último item
Shift+↑/↓	Estender a seleção para cima/para baixo
Cmd/Ctrl+↑/↓	Reorganizar os arquivos selecionados para cima/para baixo no modo de classificação manual

Observação: todos os atalhos de teclado podem ser personalizados. Consulte a seção 7 - Teclas de atalho personalizadas para obter detalhes sobre como adicionar navegação no estilo VIM (h,j,k,l), teclas alternativas e combinações de modificadores.

5 Configurações sincronizadas e locais

Muitas configurações no Notebook Navigator exibem uma alternância de sincronização - um ícone de nuvem que alterna entre "Ativar sincronização" e "Desativar sincronização". Isso controla onde cada configuração é armazenada e se ela é compartilhada entre dispositivos.

5.1 Como funciona a sincronização

Os plug-ins da Obsidian armazenam suas configurações em data.json, localizado em .obsidian/plugins/notebook-navigator/data.json dentro da pasta vault. Quando você usa um serviço de sincronização, como Obsidian Sync, iCloud, GitHub, Dropbox ou Google Drive, esse arquivo é sincronizado em todos os seus dispositivos junto com o restante do vault. Qualquer configuração salva em data.json será propagada para todos os dispositivos que sincronizarem o cofre.

Quando a sincronização está ativada (padrão) para uma configuração, o valor é salvo em data.json e sincronizado com todos os dispositivos por meio de seu serviço de sincronização.

Quando a sincronização é desativada para uma configuração, o valor é salvo no armazenamento local da Obsidian. O armazenamento local é específico do dispositivo e não está incluído na sincronização do cofre. A configuração terá seu próprio valor independente em cada dispositivo. Quando você desativa a sincronização de uma configuração, o valor atual é copiado para o armazenamento local no dispositivo atual e o valor é removido do site data.json para evitar que ele substitua os valores locais em outros dispositivos.

Se você não usar um serviço de sincronização, a alternância de sincronização não terá efeito prático, pois o data.json é armazenado apenas localmente.

6 Pesquisa

O Notebook Navigator tem dois modos de pesquisa: pesquisa com filtro e Omnisearch. Alterne entre eles usando as teclas de seta para cima/para baixo ou clicando no ícone de pesquisa. Combine nomes de arquivos, propriedades, tags, datas e filtros em uma única consulta (por exemplo, meeting .status=active #work @thisweek).

6.1 Filtrar pesquisa

Filtra arquivos por nome, tags, propriedades, datas, pastas, extensões e tarefas dentro da pasta atual e das subpastas. Modo de pesquisa padrão.

Nomes de arquivos

• word - Corresponder notas com "palavra" no nome do arquivo
• word1 word2 - Exigir que cada palavra corresponda ao nome do arquivo
• -word - Excluir notas com "word" no nome do arquivo

Tags

• #tag - Incluir notas com a tag (também corresponde a tags aninhadas como #tag/subtag)
• # - Incluir apenas notas marcadas
• -#tag - Excluir notas com etiqueta
• -# - Incluir apenas notas não marcadas
• #tag1 #tag2 - Corresponde a ambas as tags (AND implícito)
• #tag1 AND #tag2 - Corresponde a ambas as tags (AND explícito)
• #tag1 OR #tag2 - Corresponder a qualquer tag
• #a OR #b AND #c - AND tem precedência mais alta: corresponde a #a, ou ambos #b e #c
• Cmd/Ctrl+Clique em uma tag para adicionar com AND. Cmd/Ctrl+Shift+Clique para adicionar com OR

Propriedades

• .key - Incluir notas com a chave da propriedade
• .key=value - Incluir notas onde o valor da propriedade contém value
• ."Reading Status" - Chave de propriedade com espaço em branco (aspas duplas)
• ."Reading Status"="In Progress" - As chaves e os valores com espaço em branco devem estar entre aspas duplas
• -.key - Excluir notas com chave de propriedade
• -.key=value - Excluir notas em que o valor da propriedade contém value
• Cmd/Ctrl+Clique em uma propriedade para adicionar com AND. Cmd/Ctrl+Shift+Clique para adicionar com OR

Filtros

• has:task - Incluir notas com tarefas não concluídas
• -has:task - Excluir notas com tarefas não concluídas
• folder:meetings - Incluir notas onde o nome de uma pasta contém meetings
• folder:/work/meetings - Incluir notas somente em work/meetings (não em subpastas)
• folder:/ - Incluir notas somente na raiz do cofre
• -folder:archive - Excluir notas em que o nome da pasta contenha archive
• -folder:/archive - Excluir notas somente em archive (não em subpastas)
• ext:md - Incluir notas com a extensão md (ext:.md também é compatível)
• -ext:pdf - Excluir notas com extensão pdf
• Combine com tags, nomes e datas (por exemplo, folder:/work/meetings ext:md @thisweek)

Datas

• @today - Corresponder notas de hoje usando o campo de data padrão
• @yesterday, @last7d, @last30d, @thisweek, @thismonth - Intervalos de datas relativas
• @2026-02-07 - Corresponder a um único dia (também suporta @20260207)
• @2026 - Corresponder a um ano civil
• @2026-02 ou @202602 - Corresponde a um mês do calendário
• @2026-W05 ou @2026W05 - Combine uma semana ISO
• @2026-Q2 ou @2026Q2 - Corresponde a um trimestre do calendário
• @13/02/2026 - Formatos numéricos com separadores (@07022026 segue sua localidade quando ambíguo)
• @2026-02-01..2026-02-07 - Corresponder a um intervalo de dias inclusivo (com suporte de extremidades abertas)
• @c:... ou @m:... - Data de criação ou modificação do destino
• -@... - Excluir uma correspondência de data

O campo de data padrão segue a ordem de classificação atual. Ao ordenar por nome, o campo de data é configurado em Settings → Notes → Date → When sorting by name.

Comportamento AND/OR

AND e OR funcionam em consultas somente de tag/propriedade (consultas que contêm apenas os filtros #tag, -#tag, #, -#, .key, -.key, .key=value ou -.key=value ). Se a consulta também incluir nomes, datas, filtros de tarefa, filtros de pasta ou filtros de extensão, AND e OR serão correspondidos como palavras de nome de arquivo.

• Consulta do operador: #work OR .status=started
• Consulta mista: #work OR ext:md (OR é correspondido em nomes de arquivos)

6.2 Omnisearch

Pesquisa de texto completo no vault, filtrada para a pasta atual, subpastas ou tags selecionadas. Requer o plug-in Omnisearch. Se o Omnisearch não estiver instalado, a pesquisa voltará a ser pesquisa com filtro.

As visualizações de notas mostram trechos de resultados do Omnisearch em vez do texto de visualização padrão.

Limitações conhecidas

• Desempenho - Pode ser lento ao pesquisar menos de 3 caracteres em cofres grandes
• Filtros de caminho — O escopo da pasta é enviado ao Omnisearch apenas para caminhos ASCII simples. Outros caminhos são filtrados após o Omnisearch retornar os resultados
• Resultados limitados - O Omnisearch pesquisa todo o vault e retorna um número limitado de resultados antes da filtragem, de modo que os arquivos relevantes da pasta atual podem não aparecer se houver muitas correspondências em outro lugar
• Texto de visualização - As visualizações de notas são substituídas por trechos de resultados do Omnisearch, que podem não mostrar o destaque real da correspondência de pesquisa se ele aparecer em outra parte do arquivo

7 Teclas de atalho personalizadas

Edite .obsidian/plugins/notebook-navigator/data.json para personalizar as teclas de atalho do Notebook Navigator. Abra o arquivo e localize a seção keyboardShortcuts. Cada entrada mapeia uma ação para uma ou mais combinações de teclas:

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

Adicione várias associações por ação para dar suporte a chaves alternativas, como no exemplo ArrowUp e K acima. Combine modificadores em uma entrada listando cada valor, por exemplo, "modifiers": ["Mod", "Shift"]. Não há suporte para sequências de teclado como gg ou dd. Recarregue a Obsidian depois de editar o arquivo.

7.1 Modificadores

Modificador	Tecla
Mod	Cmd (macOS) / Ctrl (Win/Linux)
Alt	Alt / Option
Shift	Shift
Ctrl	Control (prefira Mod para plataforma cruzada)

7.2 Ações disponíveis

Ação	Tecla(s) padrão
pane:move-up	Seta para cima
pane:move-down	Seta para baixo
pane:page-up	Página para cima
pane:page-down	Página para baixo
pane:home	Início
pane:end	End
pane:rename	Enter (macOS), F2 (Windows/Linux)
pane:delete-selected	Delete, Backspace
navigation:collapse-or-parent	Seta para a esquerda
navigation:expand-or-focus-list	Seta para a direita
navigation:focus-list	Tab
list:focus-navigation	Seta para a esquerda, Shift+Tab
list:focus-editor	Seta para a direita, Tab
list:select-all	Mod+A
list:extend-selection-up	Shift+Seta para cima
list:extend-selection-down	Shift+Seta para baixo
list:manual-sort-up	Mod+Seta para cima
list:manual-sort-down	Mod+Seta para baixo
list:range-to-start	Shift+Home
list:range-to-end	Shift+End
search:focus-list	Tab, Enter
search:focus-navigation	Shift+Tab
search:close	Esc

8 Comandos

Defina teclas de atalho personalizadas para esses comandos nas configurações de teclas de atalho da Obsidian:

Visualização e navegação

• Notebook Navigator: Open Abre o Notebook Navigator na barra lateral esquerda. Se já estiver aberto, move o foco do teclado para o painel de lista. Sugestão: Associe a uma tecla de atalho como Cmd/Ctrl+Shift+E para mover o foco do teclado para o painel de lista - isso é essencial para a navegação completa no teclado
• Notebook Navigator: Toggle left sidebar Alterna a barra lateral esquerda. Ao abrir, define a visualização da barra lateral esquerda como Notebook Navigator (ao contrário do comando "Toggle left sidebar" incorporado da Obsidian, que restaura a visualização anterior da barra lateral esquerda)
• Notebook Navigator: Open homepage Abre o modo de exibição Notebook Navigator e carrega o destino da página inicial configurado nas configurações
• Notebook Navigator: Select vault profile Abre um modal para alternar entre perfis de cofre
• Notebook Navigator: Reveal file Revela o arquivo atual no navegador. Expande as pastas principais e rola até o arquivo. Esse comando é útil se você tiver a configuração Auto-reveal active note desativada e quiser revelar as anotações manualmente. Sugestão: Associe a uma tecla de atalho como Cmd/Ctrl+Shift+R para alterar rapidamente a pasta ou a tag selecionada para o arquivo atual
• Notebook Navigator: Open all files Abre todas as notas na pasta ou etiqueta selecionada no momento. Ao abrir 15 ou mais arquivos, mostra uma caixa de diálogo de confirmação
• Notebook Navigator: Navigate to folder Diálogo de pesquisa para ir para qualquer pasta
• Notebook Navigator: Navigate to tag Diálogo de pesquisa para ir para qualquer tag
• Notebook Navigator: Navigate to property Diálogo de pesquisa para ir para qualquer chave ou valor de propriedade
• Notebook Navigator: Navigate back Move para a pasta, tag ou seleção de propriedade anterior no histórico do navegador
• Notebook Navigator: Navigate forward Passa para a próxima seleção de pasta, tag ou propriedade no histórico do navegador
• Notebook Navigator: Add to shortcuts Adiciona ou remove o arquivo, a pasta, a tag ou a propriedade atual dos atalhos
• Notebook Navigator: Open shortcut 1-9 Abre o atalho por sua posição na lista de atalhos
• Notebook Navigator: Search Abre o campo de pesquisa rápida ou o focaliza se já estiver aberto. A pesquisa persiste entre as sessões. Sugestão: Associar a uma tecla de atalho como Cmd/Ctrl+Shift+S para filtragem rápida de arquivos
• Notebook Navigator: Search whole vault Seleciona a pasta raiz do cofre e abre a pesquisa incluindo as subpastas (requer que a função “ Show root folder ” esteja ativada)

Seleção

• Notebook Navigator: Select next file Move a seleção para o próximo arquivo na pasta atual ou na visualização de tags. Respeita a ordem de classificação personalizada. Sugestão: Associar a uma tecla de atalho como Option+Cmd+Right para ir rapidamente para o próximo arquivo na lista
• Notebook Navigator: Select previous file Move a seleção para o arquivo anterior na pasta atual ou na visualização de tag. Respeita a ordem de classificação personalizada. Sugestão: Associar a uma tecla de atalho como Option+Cmd+Left para ir rapidamente para o arquivo anterior na lista

Layout e exibição

• Notebook Navigator: Toggle dual pane layout Alternar layout de painel único/duplo (área de trabalho). Sugestão: Associar a uma tecla de atalho como Cmd/Ctrl+Shift+A para alternar rapidamente entre o layout de painel único e de painel duplo
• Notebook Navigator: Toggle dual pane orientation Alternar a orientação do painel duplo entre horizontal e vertical
• Notebook Navigator: Toggle descendants Alternar a exibição de notas de subpastas/descendentes para pastas e tags. Sugestão: Associar a uma tecla de atalho como Cmd/Ctrl+Shift+D para alternar rapidamente a exibição de notas de subpastas/descendentes
• Notebook Navigator: Toggle hidden folders, tags, and notes Mostrar ou ocultar pastas, tags e notas ocultas
• Notebook Navigator: Toggle tag sort order Alternar entre a classificação de tags por ordem alfabética e por frequência
• Notebook Navigator: Toggle tags by selection Alternar a limitação de tags para aquelas encontradas em notas dentro da pasta ou propriedade selecionada
• Notebook Navigator: Toggle properties by selection Alternar a limitação de propriedades para aquelas encontradas em notas dentro da pasta ou etiqueta selecionada
• Notebook Navigator: Toggle compact mode Alternar o modo de lista entre padrão e compacto
• Notebook Navigator: Toggle pinned section Mostrar ou ocultar notas fixadas no painel de lista
• Notebook Navigator: Collapse / expand all items Recolher ou expandir todos os itens com base no estado atual. Quando Keep selected item expanded estiver ativado (padrão ativado), todas as pastas, exceto a atual, serão recolhidas. Isso é útil para manter a árvore de navegação organizada ao pesquisar documentos
• Notebook Navigator: Collapse / expand selected item Recolher ou expandir o item de navegação selecionado

Calendário

• Notebook Navigator: Toggle calendar Ativa ou desativa o calendário. Sugestão: Associar a uma tecla de atalho como Cmd/Ctrl+Shift+C para mostrar rapidamente o calendário
• Notebook Navigator: Open daily note Abre a nota diária de hoje com base nas configurações do calendário. Cria a nota se ela não existir
• Notebook Navigator: Open weekly note Abre a nota semanal atual. Cria a nota se ela não existir
• Notebook Navigator: Open monthly note Abre a nota mensal atual. Cria a nota se ela não existir
• Notebook Navigator: Open quarterly note Abre a nota trimestral atual. Cria a nota se ela não existir
• Notebook Navigator: Open yearly note Abre a nota anual atual. Cria a nota se ela não existir

Operações de arquivo

Importante: A Obsidian não tem contexto de "pasta ou etiqueta atual", portanto, ao criar notas na Obsidian, por padrão, elas são criadas na pasta raiz, na mesma pasta do arquivo atual ou em uma pasta específica. Ao trabalhar com o Notebook Navigator, você sempre quer criar novas notas na pasta ou etiqueta selecionada no momento, portanto, a primeira coisa a fazer é vincular Cmd/Ctrl+N a Notebook Navigator: Create new note para que as novas notas sejam sempre criadas na pasta ou etiqueta selecionada no momento. O mesmo se aplica à movimentação e exclusão de arquivos. É por isso que você deve usar esses comandos em vez dos comandos integrados da Obsidian ao usar o Notebook Navigator.

• Notebook Navigator: Create new note Criar nota na pasta selecionada no momento. Sugestão: Vincular o site Cmd/Ctrl+N a esse comando (primeiro, desvincule-o do comando padrão da Obsidian "Criar nova nota")
• Notebook Navigator: Create new note from template Criar nota a partir do modelo na pasta atualmente selecionada (requer o Templater)
• Notebook Navigator: Move files Mover os arquivos selecionados para outra pasta. Seleciona o próximo arquivo na pasta atual
• Notebook Navigator: Merge notes Criar uma nota a partir de notas Markdown selecionadas na ordem da lista atual
• Notebook Navigator: Convert to folder note Crie uma pasta que corresponda ao nome do arquivo e mova o arquivo para dentro dela como a nota da pasta
• Notebook Navigator: Set as folder note Renomeie o arquivo ativo para o nome da nota da pasta
• Notebook Navigator: Detach folder note Remova a nota da pasta na pasta selecionada e renomeie-a
• Notebook Navigator: Pin all folder notes Fixar todas as notas de pasta em todas as pastas. O comando só fica visível quando as notas de pasta estão ativadas
• Notebook Navigator: Delete files Excluir arquivos selecionados. Seleciona o próximo arquivo na pasta atual

Operações de etiquetas

• Notebook Navigator: Add tag to selected files Caixa de diálogo para adicionar tags aos arquivos selecionados. Suporta a criação de novas tags
• Notebook Navigator: Set property on selected files Caixa de diálogo para definir propriedades nos arquivos selecionados
• Notebook Navigator: Remove tag from selected files Caixa de diálogo para remover uma tag específica. Remove imediatamente se houver apenas uma tag
• Notebook Navigator: Remove all tags from selected files Limpar todas as tags dos arquivos selecionados com confirmação

Manutenção

• Notebook Navigator: Rebuild cache Reconstrói o cache local do Notebook Navigator. Use essa opção se houver tags ausentes, visualizações incorretas ou imagens de recursos ausentes

8.1 IDs de comando

ID do comando	Nome do comando
notebook-navigator:open	Navegador do bloco de notas: Abrir
notebook-navigator:toggle-left-sidebar	Navegador de cadernos: Alternar barra lateral esquerda
notebook-navigator:open-homepage	Navegador do Notebook: Abrir página inicial
notebook-navigator:select-profile	Navegador do Notebook: Selecionar perfil do cofre
notebook-navigator:select-profile-1	Navegador do Notebook: Selecionar perfil do cofre 1
notebook-navigator:select-profile-2	Navegador do Notebook: Selecionar perfil do cofre 2
notebook-navigator:select-profile-3	Navegador do Notebook: Selecionar perfil do cofre 3
notebook-navigator:reveal-file	Navegador do Notebook: Exibir arquivo
notebook-navigator:open-all-files	Navegador do caderno: Abrir todos os arquivos
notebook-navigator:navigate-to-folder	Navegador do caderno: Navegar até a pasta
notebook-navigator:navigate-to-tag	Navegador do Notebook: Navegar até a tag
notebook-navigator:navigate-to-property	Navegador do caderno: Navegar até a propriedade
notebook-navigator:navigate-back	Navegador do caderno: Voltar
notebook-navigator:navigate-forward	Navegador do Caderno: Navegar para a frente
notebook-navigator:add-shortcut	Navegador do Caderno: Adicionar aos atalhos
notebook-navigator:open-shortcut-1	Navegador do Caderno: Abrir atalho 1
notebook-navigator:open-shortcut-2	Navegador do caderno: Abrir atalho 2
notebook-navigator:open-shortcut-3	Navegador do caderno: Abrir atalho 3
notebook-navigator:open-shortcut-4	Navegador do caderno: Abrir atalho 4
notebook-navigator:open-shortcut-5	Navegador de cadernos: Abrir atalho 5
notebook-navigator:open-shortcut-6	Navegador do caderno: Abrir atalho 6
notebook-navigator:open-shortcut-7	Navegador de cadernos: Abrir atalho 7
notebook-navigator:open-shortcut-8	Navegador do caderno: Abrir atalho 8
notebook-navigator:open-shortcut-9	Navegador do caderno: Abrir atalho 9
notebook-navigator:search	Navegador do caderno: Pesquisar
notebook-navigator:search-vault	Navegador do caderno: Pesquisar em todo o cofre
notebook-navigator:toggle-dual-pane	Navegador do caderno: Alternar entre o layout de painel duplo
notebook-navigator:toggle-dual-pane-orientation	Navegador do caderno: Alternar a orientação do painel duplo
notebook-navigator:toggle-calendar	Navegador do Caderno: Alternar calendário
notebook-navigator:open-daily-note	Navegador do Caderno: Abrir nota diária
notebook-navigator:open-weekly-note	Navegador do Caderno: Abrir nota semanal
notebook-navigator:open-monthly-note	Navegador do Caderno: Abrir nota mensal
notebook-navigator:open-quarterly-note	Navegador do Caderno: Abrir nota trimestral
notebook-navigator:open-yearly-note	Navegador do Caderno: Abrir nota anual
notebook-navigator:toggle-descendants	Navegador do Caderno: Alternar descendentes
notebook-navigator:toggle-hidden	Navegador do Caderno: Alternar entre pastas, tags e notas ocultas
notebook-navigator:toggle-tag-sort	Navegador do Caderno: Alternar ordem de classificação das tags
notebook-navigator:toggle-tags-by-selection	Navegador de Cadernos: Alternar entre tags por seleção
notebook-navigator:toggle-properties-by-selection	Navegador do Caderno: Alternar propriedades por seleção
notebook-navigator:toggle-compact-mode	Navegador do Caderno: Alternar para o modo compacto
notebook-navigator:toggle-pinned-section	Navegador do Caderno: Alternar seção fixada
notebook-navigator:collapse-expand	Navegador do Caderno: Recolher/expandir todos os itens
notebook-navigator:collapse-expand-selected-item	Navegador do Caderno: Recolher/expandir item selecionado
notebook-navigator:new-note	Navegador do Caderno: Criar nova nota
notebook-navigator:new-note-from-template	Navegador do Caderno: Criar nova nota a partir de um modelo
notebook-navigator:move-files	Navegador do Caderno: Mover arquivos
notebook-navigator:merge-notes	Navegador do Caderno: Mesclar notas
notebook-navigator:select-next-file	Navegador do Caderno: Selecionar o próximo arquivo
notebook-navigator:select-previous-file	Navegador do Caderno: Selecionar o arquivo anterior
notebook-navigator:convert-to-folder-note	Navegador do Caderno: Converter em nota de pasta
notebook-navigator:set-as-folder-note	Navegador do Caderno: Definir como nota de pasta
notebook-navigator:detach-folder-note	Navegador do Caderno: Desanexar nota de pasta
notebook-navigator:pin-all-folder-notes	Navegador do Caderno: Fixar todas as notas de pasta
notebook-navigator:delete-files	Navegador do Caderno: Excluir arquivos
notebook-navigator:add-tag	Navegador do Bloco de Notas: Adicionar tag aos arquivos selecionados
notebook-navigator:set-property	Navegador do Caderno: Definir propriedade nos arquivos selecionados
notebook-navigator:remove-tag	Navegador do Caderno: Remover tag dos arquivos selecionados
notebook-navigator:remove-all-tags	Navegador do Caderno: Remover todas as tags dos arquivos selecionados
notebook-navigator:rebuild-cache	Navegador do Caderno: Recriar cache

9 Recursos

9.1 Interface

• Layout de painel duplo - painel de navegação (pastas/etiquetas/propriedades) e painel de lista (arquivos)
• Modo de painel único - Navegação e exibições de lista com transições animadas
• Painéis redimensionáveis - orientação dividida horizontal ou vertical
• Zoom independente da interface do usuário - Dimensione o Navegador do Notebook sem alterar o zoom da Obsidian
• Visualização de inicialização - primeiro a navegação ou primeiro a lista
• Suporte a vários idiomas - 21 idiomas com suporte a layout RTL
• Conjunto de ícones da interface - ícones personalizáveis da interface do usuário em todo o plug-in

9.2 Navegação

• Perfis de cofre - Várias exibições filtradas com pastas/tags/notas ocultas por perfil, visibilidade de arquivos, banner e atalhos
• Atalhos — Notas, pastas, tags, propriedades e pesquisas salvas, com a opção de fixar e reordenar
• Notas/arquivos recentes - Seção de itens recentes armazenados por perfil do vault, opcionalmente fixados com atalhos
• Calendário - Calendário de anotações diárias com seleção de dias, visualizações de imagens de recursos e suporte a divisão vertical
• Árvore de pastas - Navegação de expansão/recolhimento com ordenação manual da pasta raiz
• Árvore de tags - Tags hierárquicas com ordenação configurável da tag raiz
• Navegador de propriedades - Navegue pelas propriedades do arquivo organizadas por chave e valor com contagens de arquivos, cores personalizadas, ícones e arrastar e soltar
• Revelaçãoautomática do arquivo ativo - Expansão da pasta e rolagem para seleção
• Teclado e comandos - Teclas de atalho configuráveis, comandos de retrocesso/avanço do histórico de seleção, comandos de arquivo seguinte/anterior, comandos de atalho de abertura 1-9

9.3 Organização

• Notas fixas - Mantenha notas importantes na parte superior de pastas e etiquetas
• Notas de pasta - Definir/remover notas de pasta, fixar notas de pasta, opção de abrir em uma nova guia
• Operações com tags - Adicionar/remover/limpar tags, renomear/excluir tags, criar nota na tag, arrastar e soltar a hierarquia de tags
• Classificação e agrupamento personalizados - Substitua as configurações de classificação/agrupamento por pasta ou etiqueta
• Aparências por pasta/tag - Linhas de título, linhas de visualização, modo compacto, alternância de descendentes
• Conteúdo oculto - pastas/tags/notas/arquivos ocultos com padrões, propriedades de frontmatter e filtragem baseada em tags por perfil de cofre
• Excluir pastas dos subpastas — Omitir pastas ao coletar notas das subpastas, de acordo com o perfil do cofre; as pastas excluídas permanecem visíveis e exibem suas notas quando selecionadas
• Sistema de cores e ícones - Cores de pastas/etiquetas/propriedades/arquivos, pacotes de ícones, ícones emoji/Lucide, leitura/gravação do frontmatter, mapeamento de ícones por nome de arquivo e categoria de tipo de arquivo
• Avisos de nome - Avisa sobre caracteres proibidos do sistema de arquivos e caracteres que quebram os links da Obsidian ao nomear arquivos e pastas

9.4 Exibição de arquivos

• Visualizações de notas - 1 a 5 linhas de visualização com remoção opcional de HTML
• Miniaturas — Imagens em destaque e miniaturas geradas automaticamente para arquivos PDF, SVG e de desenho armazenados no cache de metadados
• Imagens externas - Downloads opcionais para imagens externas e miniaturas do YouTube
• Agrupamento de datas - Agrupe notas por Hoje, Ontem, 7 dias anteriores, 30 dias anteriores, meses e anos quando classificadas por data
• Suporte ao frontmatter - Leia nomes de notas e registros de data e hora dos campos do frontmatter
• Anotar metadados - Mostrar data de modificação e tags na lista de arquivos
• Propriedades personalizadas - Exibir propriedades do frontmatter ou contagem de palavras na lista de arquivos com substituições por pasta/tag e cores personalizadas
• Exibição da pasta principal - Nome e ícone opcionais da pasta principal na lista de arquivos
• Modo compacto - Exibição compacta quando a visualização, a data e as imagens estão desativadas
• Tags clicáveis - As tags na lista de arquivos levam diretamente a essa tag

9.5 Produtividade

• Pesquisa - Filtre por nome de arquivo, tags, propriedades, datas, pastas, extensões e tarefas com E/OU/exclusões
• Integração com o Omnisearch - Pesquisa de texto completo via Omnisearch
• Arrastar e soltar - Movimentação de arquivos, marcação, atribuição de atalhos, reparo da árvore de tags, pastas carregadas por mola
• Menus de contexto - Crie notas/pastas/canvas/bases/desenhos e execute ações de arquivo/etiqueta
• Desenhos - Crie desenhos Excalidraw e Tldraw a partir dos menus do painel de navegação e de lista
• Modelos - Nova nota de comandos de modelo com o plug-in Templater
• Operações com arquivos - Crie, renomeie, duplique, mova e jogue na lixeira arquivos e pastas
• Filtragem - Exclusões de pastas/etiquetas/notas/arquivos com padrões e propriedades de frontmatter

10 Divulgação de rede e diagnóstico

O Notebook Navigator é executado localmente, mas alguns recursos fazem solicitações HTTP da Obsidian. O registro de depuração de inicialização também pode gravar um arquivo de diagnóstico local no seu vault.

10.1 Verificações de atualização de versão (opcional)

• Configuração: "Check for new version on start" (Verificar nova versão ao iniciar)
• Solicitação: https://api.github.com/repos/johansan/notebook-navigator/releases/latest
• Frequência: No máximo uma vez a cada 24 horas, na inicialização
• Dados: Envia metadados HTTP padrão; não inclui o conteúdo do cofre

10.2 downloads de pacotes de ícones (opcional)

• Configuração: Ative um pacote de ícones na guia Pacotes de ícones
• Solicitações: https://raw.githubusercontent.com/johansan/notebook-navigator/main/icon-assets/... (manifesto, fonte, metadados)
• Armazenamento: Armazenado localmente no IndexedDB

10.3 Imagens externas, vídeos e miniaturas do YouTube

• Imagens de recursos (opcional): Controlado pela configuração "Download external images" (Baixar imagens externas). Faz download de imagens remotas e miniaturas do YouTube para imagens de recursos e as armazena localmente no IndexedDB.
• Modal de boas-vindas (primeiro lançamento): Carrega uma miniatura estática de https://raw.githubusercontent.com/johansan/notebook-navigator/main/images/youtube-thumbnail.jpg.
• Modal What's new (na atualização/quando aberto): Carrega imagens de banner de versão do site https://raw.githubusercontent.com/johansan/notebook-navigator/main/images/version-banners/<id>.jpg para notas de versão que incluem um banner.
• Modal “Novidades” (ao atualizar / ao abrir): Carrega vídeos de lançamento do site https://raw.githubusercontent.com/johansan/notebook-navigator/main/images/version-banners/<id>.mp4 para notas de lançamento que incluem um vídeo.
• Janela modal “Novidades” (ao abrir um vídeo de lançamento): Abre vídeos de lançamento do site https://cdn.jsdelivr.net/gh/johansan/notebook-navigator@main/images/version-banners/<id>.mp4 para que os navegadores possam reproduzi-los diretamente.
• Modal What's new (na atualização/quando aberto): Carrega miniaturas do YouTube de https://img.youtube.com/vi/<id>/... para notas de versão que incluem um link do YouTube.

10.4 Arquivos de depuração de inicialização (opcional)

• Configuração: "Registro de depuração de inicialização"
• Armazenamento: Grava um arquivo nn-debug-...md com registro de data e hora na raiz do vault e, em seguida, para depois que a inicialização é estabelecida. O arquivo pode ser sincronizado se a raiz do vault estiver sincronizada.
• Dados: Inclui o tempo de inicialização, a versão do plug-in, a versão mínima compatível da Obsidian, a plataforma, a contagem de cache, a contagem de filas, o status do IndexedDB e os erros de diagnóstico. Não inclui conteúdo de notas, nomes de tags, valores de frontmatter ou uma lista de arquivos de vault.
• Caminhos e identificadores: A inicialização da inicialização, os diagnósticos de PDF e os casos de erro podem incluir o identificador do aplicativo/vault da Obsidian, caminhos de PDF relativos ao vault ou detalhes da pilha de erros. Revise e edite o arquivo antes de compartilhá-lo publicamente.
• Upload: O Notebook Navigator não faz upload de arquivos de depuração. Eles são compartilhados somente se você os carregar, anexar ou sincronizar fora do plug-in.

10.5 Privacidade e tratamento de dados

• O Notebook Navigator não envia conteúdo de notas, nomes de arquivos, tags ou arquivos de depuração para um servidor do Notebook Navigator.
• As solicitações ao GitHub, ao YouTube e a qualquer host de imagem externo são feitas diretamente do seu dispositivo e incluem metadados HTTP padrão (endereço IP, agente de usuário e similares).
• Os pacotes de ícones e as imagens baixados são armazenados localmente (IndexedDB). As notas/arquivos recentes e o estado da interface do usuário são armazenados localmente (armazenamento local Obsidian).

11 Star History

12 Contato

O Notebook Navigator foi criado e é mantido por Johan Sanneblad. Johan é PhD em Desenvolvimento de Software e trabalhou com desenvolvimento de inovação para empresas como Apple, Electronic Arts, Google, Microsoft, Lego, SKF, Volvo Cars, Volvo Group e Yamaha.

Fique à vontade para se conectar comigo no LinkedIn.

13 Dúvidas ou problemas?

Participe de nosso Discord para suporte e discussões, ou abra um problema norepositório do GitHub.

Não são aceitas solicitações de pull. Com o surgimento da programação autônoma, não é possível garantir que os códigos enviados externamente atendam aos padrões de qualidade mantidos pelo projeto; portanto, qualquer solicitação de pull é encerrada automaticamente. Em vez disso, contribua com ideias na forma de solicitações de recursos — abra uma issue. Consulte o arquivo CONTRIBUTING.md para obter mais detalhes.

14 Licença

Este projeto está licenciado sob a GNU General Public License v3.0 - consulte o arquivo LICENSE para obter detalhes.