Skip to content
אצלי
Go back

Kanban dentro do Standard Notes, com o board salvo em Markdown

Updated:
Quadro Kanban dentro do Standard Notes na visão Matrix, com a lista Unclassified e os quadrantes Do, Schedule, Delegate e Eliminate da matriz de Eisenhower, cada cartão com a coluna de origem e as labels

Também disponível em inglês: Kanban inside Standard Notes, with the board saved as Markdown.

No post anterior apresentei o cliente de API para o Standard Notes. Este é o outro plugin: o StandardNotes-kanban, um quadro Kanban cujo estado vive dentro de uma nota.

O conceito do board e as primeiras versões são do corvec (sn-kanban-editor), e o crédito está no README.

Editor Kanban aberto em uma nota chamada "plugin project", com uma barra de busca seguida dos botões Board, Matrix e Done (8). O quadro tem cinco colunas: Backlog com 4 cartões, To Do com 3, In Progress com 2, Review com 2 e Done com 8. Os cartões têm labels coloridas, como blue, green, orange e purple, e alguns exibem um prazo, em vermelho quando está vencido

O board da imagem é o do próprio projeto. Dá para ler o histórico na coluna Done: a migração para Vite e React 18 derrubou o build de 30 para 0,5 segundo e o tamanho de 245 kB para 91 kB com gzip.

O que tem

Colunas e cartões com título, descrição, labels, checklist, prazo e comentários. Arrastar e soltar entre colunas e dentro delas, com suporte a arrastar pelo teclado. Colunas podem ser reordenadas, renomeadas e recolhidas, e as recolhidas são lembradas por nota em cada dispositivo. O menu ⋮ de uma coluna a marca como concluída, conclui ou apaga todos os cartões dela, ou apaga a coluna, sempre com Undo. O cabeçalho mostra a contagem de cartões, e o modal do cartão tem um seletor Move to para mandar o cartão para qualquer coluna.

A busca cobre título, descrição e labels, e dá para estreitá-la: label:work mantém uma label, e due:overdue, due:today ou due:week filtram por prazo. Você pode digitá-los na busca ou ligá-los na barra de filtros logo abaixo, e clicar em uma label de um cartão filtra por ela.

Ctrl/Cmd+Z e Ctrl/Cmd+Shift+Z desfazem e refazem alterações no board, e remover um cartão ou uma coluna oferece um Undo.

Os atalhos: N cria um cartão, Ctrl/Cmd+F foca a busca, e Alt+Left e Alt+Right movem o último cartão clicado para a coluna vizinha. O editor segue o tema selecionado no app e funciona nos apps web, desktop e mobile.

Uma coluna de concluídos e uma matriz de Eisenhower

Dá para marcar colunas como de concluídos. Elas saem do board, que fica mais curto, e um botão Done (N) na barra de ferramentas mostra ou esconde essas colunas. Concluir um cartão o manda para a primeira coluna de concluídos. Enquanto ela está visível, o Clear done remove os cartões terminados, com Undo.

O seletor Board | Matrix troca para uma matriz de Eisenhower: os mesmos cartões separados em Do, Schedule, Delegate e Eliminate, mais uma lista de Unclassified. Arraste os cartões entre os quadrantes ou escolha um no modal do cartão, e renomeie um quadrante clicando no título. A visão escolhida é lembrada por nota em cada dispositivo, e no celular cada seção pode ser dobrada pelo título.

O mesmo board na visão Matrix. À esquerda, a lista Unclassified, vazia, e quatro quadrantes: Do com 4 cartões, Schedule com 5, Delegate com 6 e Eliminate com 4. Cada cartão mostra a coluna de origem e as labels, e os cartões concluídos aparecem riscados

O menu Export leva o board para fora da nota: copie ou baixe tudo como JSON, ou uma linha por cartão como CSV.

O board é só Markdown

O corpo da nota é Markdown comum: um # por coluna, um * por cartão, bullets indentados para os campos.

Labels: work=blue

# To Do
* Write the report [id:a3f9k2]
  * Description: Q4 numbers, then review with the team
    > bring the spreadsheet
  * Due: 2026-09-30
  * Label: work, blue
  * Quadrant: do
  * Checklist:
    [x] first draft
    [ ] review with the team
  * Comments:
    * First draft looks good
* Call the bank

# Done [done]
* Book the flights

Uma descrição continua em linhas com >. Qualquer texto serve como label, e a linha opcional Labels: dá a uma label uma cor da paleta (red, orange, yellow, green, blue, purple, pink), aplicada a todos os cartões que a usam. Um checklist mostra no cartão um contador 3/7 com uma barra de progresso. O campo Quadrant coloca o cartão na matriz com uma chave fixa (do, schedule, delegate ou eliminate), então renomear um quadrante nunca reescreve os cartões, e [done] depois do título de uma coluna marca a coluna de concluídos. Os quadrantes renomeados ficam em uma linha opcional Quadrants: antes da primeira coluna.

Isso tem duas consequências práticas. Qualquer outro editor lê e altera o board sem quebrá-lo, e a nota continua útil se um dia você abandonar o plugin. E as linhas que o parser não entende são preservadas como estão e sinalizadas em um aviso no topo do quadro, em vez de sumirem. Os marcadores [id:xxxxxx] são gerenciados pelo editor e recriados quando faltam. Notas salvas pela primeira versão, em JSON, são convertidas para Markdown na primeira edição.

Instalação

  1. No Standard Notes (web ou desktop), abra Preferences, depois Plugins.

  2. No fim da página, cole a URL abaixo em Install Custom Plugin:

    https://esli.cafe/StandardNotes-kanban/ext.json
  3. Crie uma nota, abra o menu Editor e escolha Kanban.

O editor não envia nada para lugar nenhum. Tudo fica na nota, criptografado com o resto dos seus dados.

Como foi feito

É React 18 e TypeScript, com build pelo Vite. O arrastar e soltar, pelo teclado incluído, vem do @hello-pangea/dnd, o fork mantido do react-beautiful-dnd, e o editor de cartão é um diálogo do react-modal. O formato Markdown tem parser e gerador próprios em TypeScript: a nota é lida como um board, alterada por pequenas operações puras e escrita de volta, levando junto as linhas desconhecidas. Como as operações são puras, undo e redo são só pilhas de boards inteiros, até 50 passos. O editor conversa com o app pelo component relay do Standard Notes, com uma proteção que ignora o eco dos próprios salvamentos, e a Content Security Policy só permite scripts e conexões da origem do próprio plugin. O Vitest cobre a lógica e os componentes, com testes de propriedade do fast-check que conferem que escrever um board e lê-lo de novo dá o mesmo board, e o Playwright conduz o plugin compilado por um host falso do Standard Notes, incluindo a origem opaca e a CPU mais lenta do app mobile.

A versão atual é a v1.11.0, licença AGPL-3.0. O código está em github.com/Esl1h/StandardNotes-kanban.


Share this post on:

Previous Post
Um cliente de API dentro do Standard Notes, com sintaxe .http e criptografia ponta a ponta
Next Post
Um editor Markdown visual para o Standard Notes, com a nota guardada como Markdown puro