Obsidian Stats logoObsidian Stats

Note Comments

by Rafael Santos
5
4
3
2
1
Score: 35/100
New Plugin
Install Code

Description

Adicione comentários a trechos de texto com destaque colorido e um painel lateral. Os comentários ficam em notas separadas, linkadas ao documento. - This plugin has not been manually reviewed by Obsidian staff.

Reviews

No reviews yet.

Stats

stars
downloads
0
forks
0
days
NaN
days
NaN
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
0
commits

Latest Version

Invalid date

Changelog

See all version on GitHub

README file from

Github

Note Comments — plugin para Obsidian

Adiciona comentários ancorados a qualquer trecho de texto (uma palavra, frase ou parágrafo), com destaque colorido + sublinhado ligados ao tema, e um painel lateral com ordenação.

Documento com trechos comentados e o painel lateral de comentários

Funcionalidades

  • Comentar via botão direito: selecione um trecho → menu de contexto → Adicionar comentário. Também disponível como comando.
  • Destaque do trecho com fundo (--text-highlight-bg) e sublinhado (--text-accent) — respeita tema claro/escuro. Funciona em Live Preview, Source e modo Leitura.
  • Painel à direita listando todos os comentários do documento, com ordenação crescente/decrescente por posição ou por data.
  • Documento limpo: nada é inserido no seu markdown. A âncora é o próprio trecho + contexto, reencontrado automaticamente (estilo text quote selector). Se um trecho for muito reescrito, o comentário vira "órfão" (mostrado esmaecido no painel) em vez de se perder silenciosamente.
  • Armazenamento: uma nota por documento, dentro da pasta configurável, espelhando o caminho de origem e com backlink [[documento]]. A nota é legível (callouts) e tem um bloco %% ... %% oculto com o JSON, que é a fonte da verdade.

Capturas de tela

Painel com histórico — cada comentário guarda a trilha criado → editado → concluído; os concluídos aparecem riscados.

Painel de comentários com a trilha de histórico

Filtrar concluídos — o ícone de olho esconde os comentários já resolvidos, deixando só os pendentes.

Painel filtrando apenas os comentários pendentes

Ordenação — por posição no documento ou por data (mais antigos / mais recentes).

Menu de ordenação do painel

Configurável — pasta das notas, tamanho do contexto da âncora, ordenação padrão e as cores de realce (pendente / concluído).

Tela de configurações do plugin

Como a âncora funciona

Ao comentar, guardamos quote (o trecho), prefix e suffix (alguns caracteres ao redor). Para destacar, reencontramos a posição no texto atual:

  1. casamento exato de prefix + quote + suffix;
  2. se houver várias ocorrências do trecho, escolhemos a de contexto mais parecido;
  3. se não existe mais, o comentário fica órfão.

Durante a edição, os destaques se movem junto com o texto (mapeamento de decorations do CodeMirror), então só recorremos ao reencontro ao reabrir.

Desenvolvimento

npm install
npm run dev     # build com watch
npm run build   # build de produção + type-check

Para testar: copie main.js, manifest.json e styles.css para <vault>/.obsidian/plugins/note-comments/ e ative o plugin.

Limitações conhecidas (v0.1)

  • No modo leitura, destacamos a primeira ocorrência do trecho dentro de cada bloco e apenas quando ele cabe num único nó de texto (sem formatação no meio).
  • O reencontro é por texto exato; reescritas grandes do trecho criam órfãos.
  • Uma cor por destaque é suportada no modelo de dados (color), mas ainda não há UI para escolhê-la.
Sponsors