Editar arquivos Markdown no local

Alguns Markdown vivem fora de suas anotações: um README em um repositório Git, um arquivo no iCloud Drive, notas que um colega lhe enviou. O Varlig pode editar esses arquivos onde estão, sem copiá-los para a sua biblioteca.

Abra um arquivo

Escolha File › Open Markdown File… (⌥⌘O), abra o arquivo no Finder com Open With ▸ Varlig ou execute open -a Varlig notes.md no Terminal. O Varlig abre arquivos .md, .markdown, .txt e outros formatos semelhantes de texto simples, com até 32 MB.

Uma janela de arquivo se parece com o editor que você conhece, com um emblema de FILE, o nome do arquivo, sua pasta e seu estado de salvamento no cabeçalho. O botão de pasta revela isso no Finder.

Abra uma pasta

Escolha File › Open Folder… (⌃⌘O), solte uma pasta no ícone do Varlig no Dock ou execute open -a Varlig ~/Projects/handbook no Terminal. Uma janela de pasta lista o Markdown da pasta e os arquivos de texto em uma barra lateral, agrupados por subpasta, e edita o que você escolher no mesmo editor que uma janela de arquivo. Ele abre no README, se houver um, e retorna ao arquivo que você leu pela última vez.

A lista segue a pasta à medida que ela muda: arquivos que outro aplicativo ou um git checkout adiciona, remove ou renomeiam aparecem e desaparecem por conta própria. Pastas ocultas, como .git e node_modules, são deixadas de fora. Filter files restringe a lista por nome ou caminho, e + cria um novo e vazio Untitled.md ao lado do arquivo que você está lendo. Escolher outro arquivo salva o que você deixa, e um link relativo para um arquivo na mesma pasta o abre na mesma janela.

O Varlig grava apenas os seus arquivos nessa pasta — sem banco de dados nem configurações ocultas. Assim, ela continua tão portátil quanto antes.

Salvar alterações

As edições se salvam cerca de um segundo depois que você para de digitar, e File › Save (⌘S) salva imediatamente. O cabeçalho mostra Saved, Edited ou Save failed com o motivo.

Varlig escreve o arquivo da maneira que o encontrou: as mesmas terminações de linha, a mesma marca de ordem de bytes e uma nova linha final apenas se tiver uma. As gravações são atômicas e mantêm as permissões do arquivo, portanto, um arquivo rastreado pelo Git mostra uma diferença limpa e mínima.

File › Save As… escreve uma cópia em outro lugar e continua editando essa cópia.

Fotos e links ao lado do arquivo

As referências relativas partem da pasta do próprio arquivo. Por isso, ![](diagrams/flow.png) e [the plan](plan.md) abrem os destinos esperados, até três níveis de pasta acima do arquivo. Uma imagem colada ou arrastada para o texto é salva ao lado do arquivo, em uma pasta com o nome dele, como notes.assets/.

Tags e [[note links]] são texto comum em uma janela de arquivo: eles pertencem à sua biblioteca, e um arquivo no disco não tem onde mantê-los.

Quando o arquivo muda no disco

Se outro processo alterar o arquivo enquanto houver edições suas ainda não salvas — um git pull, um cliente de sincronização ou outro editor —, o Varlig preserva as duas versões e avisa:

• Compare… mostra os dois lado a lado, marcando o que está apenas no disco e o que está apenas na sua janela.
• Keep Mine salva sua versão e mantém a versão em disco como uma cópia datada ao lado do arquivo.
• Use Disk Version mostra a versão do disco e mantém a sua como uma cópia datada ao lado do arquivo.

Nenhuma versão é perdida em nenhuma das opções. As cópias recebem nomes que permitem distingui-las, como notes (disk version 2026-09-22 1415).md.

Se o arquivo for excluído ou movido enquanto você estiver editando, o Varlig informa e oferece Save As…, para que seu texto nunca fique preso.

Os formatos de resposta permanecem com o arquivo

O formato do resultado de cada linha — casas decimais, separadores e notação — e a configuração Subtotal ou Time Point ficam nos metadados do arquivo, em um atributo estendido, sem alterar o Markdown. O texto continua exatamente como você o escreveu. Ao reabrir o arquivo, em uma janela de arquivo ou de pasta, cada linha mantém sua aparência. Linhas editadas, inseridas ou movidas preservam suas configurações; quando o texto de uma linha é removido, as configurações dela são descartadas, em vez de passar para outra linha.

Algumas ferramentas não preservam atributos estendidos: Git, a maioria dos compactadores zip, alguns serviços de sincronização e discos formatados para Windows. Nesse caso, os formatos voltam aos padrões, sem afetar o texto. Para impedir que o Varlig grave qualquer metadado no arquivo, desative Remember answer formats in Markdown files em Settings › Editor. Essa opção vem ativada.

O que há de diferente em uma janela de arquivo?

• Sem histórico de versões, sem senha de nota e sem backups: o arquivo no disco é a única cópia.
• Os blocos de cálculo funcionam como de costume. Um formato de resposta ou configuração de linha que você escolher para uma linha é mantido com o arquivo, como acima, não em seu texto.
• Links varlig:// abrem uma nota; nunca executam automações a partir de um arquivo.