Como evitamos que o arquivo seja corrompido mesmo se o aplicativo fechar durante o salvamento

O que acontece se faltar energia no exato momento em que um arquivo está sendo salvo?

Normalmente, o arquivo pode ficar salvo apenas pela metade. Isso não deveria acontecer em um editor feito para ser usado por muito tempo. Por isso, mesmo quando o salvamento falha, o mote protege o arquivo original.

Primeiro, ele cria um arquivo temporário na mesma pasta do documento. Depois de gravar todo o conteúdo, ele o sincroniza com o disco e copia as permissões do arquivo original. Quando tudo está pronto, ele renomeia o arquivo temporário com o nome original.

A mudança de nome acontece de uma só vez. Mesmo que falte energia durante o processo, o que permanece é o arquivo anterior ou o novo arquivo. Não fica nenhum arquivo salvo pela metade.

As permissões também são mantidas como estavam. Afinal, salvar significa alterar o conteúdo, não alterar quem pode ler o arquivo.

Os bytes do documento também não são modificados. Quebras de linha CRLF, BOM, quebras de linha misturadas e até a presença ou ausência de uma quebra de linha no final são preservados no salvamento. Se você abriu um arquivo e não alterou nada, nenhum byte deve mudar ao salvá-lo novamente. O mote testa esse princípio a cada lançamento.

Os links não são quebrados

Nem mesmo uma forma segura de salvar pode ser aplicada da mesma maneira a todos os arquivos.

Se um link simbólico for substituído como se fosse um arquivo comum, o link desaparecerá. O conteúdo editado também não será aplicado ao documento para o qual o link apontava. O mote segue o link e salva o arquivo real. O link permanece intacto.

Links físicos fazem com que vários nomes apontem para o mesmo arquivo. Se apenas um desses nomes for substituído por um novo arquivo, a ligação será quebrada. Por isso, arquivos com links físicos são sobrescritos no próprio local. A atomicidade é sacrificada, mas o risco é reduzido com um backup criado imediatamente antes do salvamento.

Arquivos que não puderam ser lidos não são salvos

Antes de salvar, o mote lê primeiro o arquivo que está no disco.

Se o arquivo não existir, ele cria um novo. Se puder ser lido, ele faz um backup e depois salva. Se o arquivo existir, mas não puder ser lido, o salvamento é interrompido.

Isso inclui documentos antigos com codificação incompatível, pastas e arquivos sem permissão de acesso. Se um arquivo que não pôde ser lido for exibido como um documento vazio e depois sobrescrito, até o conteúdo que o usuário não conseguiu ver poderá desaparecer por completo.

Se o arquivo não puder ser lido, também não será possível criar um backup. Por isso, não salvar é a única maneira de proteger o arquivo.

Backups e rascunhos não são criados ao lado do documento

O arquivo anterior ao salvamento é copiado para a pasta de estado. O nome inclui o nome do documento e a data e hora do salvamento.

문서이름.2026-09-07-153914.md

Os 20 backups mais recentes de cada documento são mantidos, e os mais antigos são apagados primeiro. É possível saber quando cada backup foi criado apenas pelo nome do arquivo e abri-lo diretamente no editor que você costuma usar.

Um documento que nunca foi salvo não tem um original para ser copiado. Em vez disso, é criado um rascunho. Quando se passa 1 segundo desde que a edição foi interrompida, uma cópia é salva na pasta de estado. O nome inclui a data e hora e o primeiro título do documento.

Quando o arquivo é salvo ou o usuário descarta o documento, o rascunho também é apagado. O mesmo acontece quando o aplicativo é encerrado. Se houver um local onde salvar, ele é salvo como arquivo; caso contrário, permanece como rascunho.

Arquivos temporários deixados por uma falha também são removidos na próxima vez que o documento é aberto. No entanto, se o processo que criou o arquivo ainda estiver em execução, ele não é alterado. Isso porque outra janela pode estar salvando o documento.

Documentos em /tmp ou em pastas de cache podem desaparecer quando o computador for reiniciado. Ao abrir um documento assim, o mote exibe um aviso para salvá-lo em outro local.

Fora isso, nenhum arquivo auxiliar é criado na pasta do documento. Configurações, backups, rascunhos e informações sobre o último arquivo aberto são armazenados na pasta de estado dentro da pasta pessoal do usuário. Não foram incluídos recursos que precisem armazenar separadamente estados que não podem ser registrados em Markdown.

Os backups são necessários quando não é possível voltar usando o recurso de desfazer. Por exemplo, depois de reabrir o aplicativo ou quando você percebe muito tempo depois que salvou algo por engano. Ao abrir um arquivo de backup, é possível ver exatamente como estava o documento imediatamente antes de ser sobrescrito em cada salvamento.

Arquivos e rede só são acessados com a permissão do usuário

O salvamento automático precisa ser ativado manualmente nas configurações. Também é possível escolher quanto tempo esperar antes de salvar.

Quando está ativado, o documento é salvo após o tempo configurado ter se passado desde que a edição foi interrompida. O método de salvamento é o mesmo usado no salvamento manual. Primeiro é feito um backup, depois é criado um arquivo temporário e, por fim, ele é trocado pelo arquivo original. O salvamento automático não é um recurso de salvamento separado, mas um temporizador que inicia o mesmo salvamento em seu lugar. Ele só funciona quando há edição.

A verificação de atualizações também precisa ser ativada manualmente. Quando está desativada, o mote não usa a rede.

Quando está ativada, uma verificação é feita uma vez em segundo plano após o aplicativo ser iniciado. O limite de “uma vez por dia” não é controlado por uma contagem de tempo feita pelo aplicativo, mas por um arquivo de marcação na pasta de estado. Enquanto o aplicativo permanece aberto, ele não verifica novamente e também não mantém nenhum temporizador em execução contínua.

Mesmo quando há uma nova versão, ela não é baixada imediatamente. Apenas uma notificação é exibida no canto inferior direito da tela. Até que o usuário clique nela, nenhum download, instalação ou reinicialização é realizado.

O único formato que o próprio aplicativo pode atualizar é o AppImage. Isso porque basta substituir um único arquivo. Se a instalação tiver sido feita por apt ou Flatpak, o mote apenas informa o comando apropriado. O próprio usuário é quem o executa.

Ao verificar atualizações, são enviados apenas a plataforma e o canal de distribuição. Nenhuma informação que identifique o usuário ou sobre os documentos abertos é enviada.

Um salvamento seguro não é um salvamento que sempre dá certo. É um salvamento que não causa perdas mesmo quando falha.