Primeiros Passos

Última revisão: 2026-10-23

Esta página leva você da instalação ao primeiro trabalho de verdade: abrir ou criar um vault, conhecer a interface e entender os três modos do editor.

Pacote da comunidade para Arch Linux: plainva no AUR é mantido de forma independente. Confira o PKGBUILD antes de compilar; o projeto Plainva não verifica essas compilações da comunidade. O aplicativo continua sob a licença AGPL-3.0-only.

Requisitos do sistema

O Plainva desenha sua janela com o motor web do sistema — é o motor, não o processador, que define o mínimo:

O limite do motor é o Safari 16.4, e no macOS é a versão do sistema que decide isso: um app desenha sua janela com a WebView do sistema, que chega junto com as atualizações do macOS, e não com o Safari. Em um Mac que a Apple não atualiza mais, o Safari pode, portanto, ser muito mais novo do que o motor que qualquer outro app recebe — o Monterey fica travado no Safari 15.6.1, por mais atualizado que esteja o seu Safari. O Ventura alcançou a versão 16.4 na 13.3, e é aí que fica o limite mínimo; instalar um Safari mais recente não o move.

Em um sistema abaixo desse mínimo, o Plainva avisa na inicialização em vez de abrir uma janela em branco.

Linux: qual arquivo escolher. No Fedora, no openSUSE e em outras distribuições baseadas em RPM, instale o .rpm; no Debian e no Ubuntu, o .deb — ambos usam as bibliotecas WebKitGTK, Mesa e Wayland do seu sistema. O .AppImage é a alternativa para distribuições sem pacote: ele traz cópias próprias de algumas bibliotecas, e em um sistema muito novo (Mesa 25 ou mais recente) elas podem entrar em conflito com a pilha gráfica do sistema. Os AppImages criados depois da 0.8.0 contornam isso na inicialização; se uma janela ainda assim ficar em branco, inicie-o em um terminal e leia a mensagem — EGL_BAD_PARAMETER aponta exatamente para isso, e o .rpm ou o .deb é a forma de contornar. Uma janela em branco em uma placa NVIDIA é outra questão: tente WEBKIT_DISABLE_DMABUF_RENDERER=1 ./Plainva*.AppImage (uma configuração do WebKitGTK; veja as notas do Tauri sobre gráficos no Linux).

O que é um vault?

Um vault é uma pasta comum no seu computador que guarda suas notas em Markdown. O Plainva adiciona uma subpasta oculta .plainva/ para o índice de busca e as configurações — suas notas em si continuam sendo arquivos .md intocados. Você pode ter vários vaults (por exemplo, “Pessoal” e “Trabalho”) e alternar entre eles.

Abrir ou criar um vault

Na primeiríssima inicialização — antes de você ter aberto um vault alguma vez — o Plainva mostra, uma única vez, uma breve mensagem de boas-vindas. Em três linhas, ela explica em que o Plainva se baseia, mostra ao lado uma pequena prévia da interface e já oferece as três formas de entrar: Abrir vault, Novo vault e Importar de outro aplicativo. Depois ignora a mensagem e deixa você na tela de boas-vindas normal; ela não volta a aparecer — a menos que você a chame novamente em Configurações → Inicialização e comportamento → Tela de boas-vindas.

Depois de uma atualização, o mesmo lugar mostra o que mudou: a maior novidade dessa versão com um título próprio, e o restante em uma linha cada. Isso aparece uma vez por versão — você pode chamá-lo novamente a qualquer momento em Configurações → Inicialização e comportamento → Mostrar destaques da versão novamente.

Ao iniciar, a tela de boas-vindas recebe você:

Vaults recentes lista tudo o que você já abriu antes. Remover da lista remove uma entrada apenas do Plainva — os arquivos permanecem no disco. Ative Abrir automaticamente o último vault ao iniciar para pular a tela de boas-vindas no futuro. Ao remover, o Plainva pergunta se você também quer esquecer todos os dados do aplicativo do vault (índice de busca, configurações, layout da janela, credenciais de sincronização, calendário e caixas de correio; backups ZIP automáticos apenas pela caixa extra) — sua pasta do vault permanece intacta em qualquer caso.

Plainva Tour · Visão geral

Comece com um exercício pequeno ou abra um banco diretamente. As cinco primeiras etapas mostram o uso diário; o restante é opcional. Reserve cerca de 10–15 minutos para conhecer o espaço e quanto tempo quiser para experimentar. Os exemplos são fictícios e podem ser alterados.

Abrir: Passeio/01 Escrever e conectar.md

  1. Escrever e conectar
  2. De nota a tarefa
  3. Planejar um projeto
  4. Encontrar e organizar
  5. Organizar um dia
  6. Revisar uma nota
  7. Comparar versões
  8. Descobrir o que ajuda
  9. Contas, dispositivos e importação
  10. Compartilhar e automatizar

O pacote fictício contém exatamente duas notas com a tag tour-import e nenhuma apagada. O relatório deve indicar duas notas importadas. Para desfazer, apague somente a nova subpasta.

Espaços criptografados e compartilhamento são experimentais: precisam de identidades, chaves e serviço conectado. Explore papéis, convites e publicações com dados de teste separados. Scripts e automações exigem configuração e permissões conscientes. O modelo não executa scripts, contata serviços nem simula acessos.

Versão dos dados: 2026-09-11. As datas correspondem à criação deste Vault. Atualizações de modelos valem somente para novos Vaults futuros; este nunca é alterado ou complementado por um modelo.

Escolha uma pasta local nova e vazia e, para criar online, uma pasta de nuvem vazia. Vaults existentes abrem sem aplicar modelos. Remover arquivos ou trocar de dispositivo nunca permite aplicar uma atualização de modelo a eles.

A interface

Os três modos do editor

Alterne o modo no canto superior direito do editor:

ModoPara que serve
Modo de leituraVisualização totalmente renderizada para ler e navegar. Os links abrem direto dentro do Plainva.
Visualização ao vivoO padrão para escrever: o Markdown é renderizado enquanto você digita; os caracteres de formatação só aparecem onde você está trabalhando.
Código MarkdownO texto bruto sem renderização — para controle total.

Qual modo as notas abrem é você quem escolhe: selecione a Visualização padrão em Configurações → App → Editor e notas (leitura, ao vivo ou código). Alternar o modo no editor vale para aquele arquivo durante a sessão atual. Uma nota recém-criada sempre abre para escrita — com Modo de leitura como padrão, ela abre em Visualização ao vivo.

Você também pode alternar entre Largura de leitura e Largura total.

Fundamentos da árvore de arquivos

Notas diárias

O botão Nota diária, na barra de ações à esquerda, abre ou cria a nota de hoje. Configure a pasta base, o formato de data e um modelo opcional em Configurações → Vault → Conteúdo e estrutura (Escolher pasta… ao lado do campo permite escolher a pasta diretamente no vault).

O formato de data usa os mesmos tokens do Obsidian: YYYY ano, MM mês, DD dia, dddd nome do dia — YYYY-MM-DD dddd resulta em 2026-07-29 Wednesday. Texto que deve permanecer como está vai entre colchetes: [Diário] YYYY-MM-DD. Nomes de meses e dias estão sempre em inglês, assim mudar o idioma do aplicativo nunca torna suas notas diárias existentes impossíveis de encontrar.

O Calendário à direita é uma visão geral do dia: clicar em uma data abre a aba do calendário naquele dia; um clique com o botão direito abre um menu que nomeia o dia no topo e oferece Abrir calendário, Nota diária e os eventos e as tarefas com vencimento daquele dia. Dias com uma nota diária trazem um pequeno ícone de sol, dias com eventos, pontos coloridos por calendário. O botão Hoje leva você de volta ao mês atual; clicar no nome do mês abre um seletor rápido de mês/ano. Lá você também pode ativar Mostrar números da semana para adicionar uma coluna com a semana ISO — a configuração é lembrada e vale para todos os calendários neste dispositivo (veja Calendário).

A forma mais rápida de chegar à nota de hoje é o diário: Ctrl+Shift+J recebe uma linha, carimba a hora e a acrescenta sob o título Journal da nota diária de hoje — sem abrir a nota. Abrir diário na barra de ações mostra as entradas de todos os dias como um único fluxo. Veja Diário.

Configurações

Configurações (ícone de engrenagem na parte inferior da barra de ações à extrema esquerda, ou Ctrl+,) fecham pelo X no canto superior direito, Esc ou um clique fora da janela. As alterações são salvas imediatamente e automaticamente — apenas as credenciais na nuvem são aplicadas deliberadamente por Login na área Contas na nuvem (veja Configurar Sincronização). As configurações se dividem em duas partes; cada área na barra lateral esquerda abre sua própria página, onde as configurações ficam em cartões de grupo nomeados:

Abas

Várias janelas

O Plainva não precisa ficar em uma única janela. O que você precisa agora pode ficar ao lado do seu trabalho:

Uma janela destacada é um Plainva completo: ela tem abas, pode ser dividida e salva pela mesma cadeia que a janela principal. O que ela deliberadamente não tem são as barras laterais e a barra de ações — ela foi feita para mostrar uma única coisa.

Uma segunda janela tem essas duas — e tem seu próprio vault. Ela abre no vault da janela principal; o seletor de vault no canto inferior esquerdo a move para outro sem arrastar a janela principal junto. As configurações, o assistente de importação e criar um vault ficam na janela principal — os botões estão lá, e clicar em um deles traz a janela principal para a frente e a abre ali. Tudo relacionado ao seu trabalho é igual nas duas: editar, salvar, buscar e o estado de sincronização na barra de status. A largura das barras laterais e o que você recolheu pertencem a cada janela separadamente.

Um conteúdo está sempre aberto em apenas UMA janela. Abrir uma nota que já está exibida em outro lugar traz aquela janela para a frente. Isso é intencional: dois editores no mesmo arquivo são o jeito mais certo de perder trabalho. Redigir é a exceção — escrever duas mensagens ao mesmo tempo é normal.

O ícone Sempre visível no título da janela mantém uma janela em primeiro plano enquanto você trabalha na outra.

Na próxima inicialização, todo vault que tinha uma janela volta, e suas janelas adicionais voltam para onde estavam. Se você preferir que não voltem: Configurações → Inicialização e comportamento → Janelas. Uma mensagem não enviada nunca é restaurada — o que está em uma janela de redação vive na memória, e uma janela que afirmasse tê-la guardado seria pior do que nenhuma janela.

Vários vaults ao mesmo tempo

Dois vaults lado a lado — trabalho e pessoal, projeto e arquivo — precisam de duas janelas: uma janela mostra exatamente um vault. Abra uma segunda janela (paleta de comandos → Abrir uma segunda janela) e troque o vault dela no canto inferior esquerdo. A partir daí, as duas rodam: sua própria busca, sua própria sincronização, seus próprios lembretes.

Barras e áreas

A barra de ações na extrema esquerda, as abas da barra lateral esquerda, as seções acima da árvore de arquivos e as seções da barra lateral direita funcionam todas da mesma forma.

A barra de ações oferece Nova nota, Nova pasta e Novo banco de dados (.base). As três criam o item dentro da pasta selecionada na árvore de arquivos; com um arquivo selecionado, na pasta desse arquivo; sem nada selecionado, na raiz. A Nota diária não segue essa regra — ela sempre vai para a pasta que você definiu para isso nas configurações. Se você não precisar de uma das três, oculte-a.

Bem onde estão: pressione e segure um botão ou o título de uma seção e arraste-o até o novo lugar — um clique simples continua apenas acionando-o, e se você rolar a tela enquanto segura, a rolagem acontece normalmente (o arraste é cancelado). Esc cancela um arraste em andamento. Um clique com o botão direito oferece as mesmas ações sem precisar segurar: Mover para cima, Ocultar e Personalizar barras….

Em um só lugar: em Configurações → Vault → Barras e áreas, as cinco barras ficam uma abaixo da outra — inclusive a barra de navegação do telefone, que assim você organiza na tela grande. Cada uma é uma lista com uma linha divisória: tudo acima dela está visível, tudo abaixo está oculto. Aqui você move os itens pela alça de arraste — nesta página você está organizando uma lista, que é exatamente para isso que uma alça serve. Arrastar até a borda superior ou inferior rola a página junto, de modo que um item pode ir do fundo até o topo em um único movimento. Organizar barras …, o botão com os controles deslizantes no fim do grupo superior da barra de ações, abre esta página diretamente.

Duas coisas propositalmente não podem ser ocultadas: Ajuda e Configurações, na parte inferior da barra de ações, e a aba Arquivos da barra lateral esquerda. Tudo o mais é seu para ocultar; as ações ocultas da barra continuam acessíveis pela paleta de comandos (Ctrl+P). Seções da barra lateral direita que não têm nada a mostrar para a nota aberta nunca chegam a aparecer.

A organização pertence ao vault e viaja para seus outros dispositivos (veja Configurar Sincronização). Um vault que você não adaptou segue o seu padrão — defina-o com Salvar como padrão, e Restaurar o padrão devolve a ele um vault adaptado.

Personalizando a interface

O grafo

Por Ctrl/Cmd+Shift+G (ou a seção Grafo na barra lateral direita) você vê seu vault como um mapa: pastas como bolhas, notas como nós, relações como arestas rotuladas — incluindo um modo de limpeza e viagem no tempo. Detalhes: Grafo.

Memória da barra lateral direita

Seções sem nada para mostrar na nota aberta — Estrutura, Backlinks, Propriedades, Bancos de dados — não aparecem de forma alguma, em vez de ficarem ali acinzentadas. A barra lateral direita inteira lembra uma única preferência global para as notas; visualizações em tela cheia sem contexto de nota a fecham apenas temporariamente.

Quando você arrasta o painel para deixá-lo estreito, ele muda em três estágios, para que nada quebre. O que conta é a largura do próprio painel — se o conteúdo rola ou não, não muda nada — e uma janela nova o abre com 300 px:

A barra lateral direita não pode ficar abaixo de 200 px — nenhuma seção fica utilizável abaixo disso. A esquerda ainda vai até 150 px, porque os nomes de arquivo simplesmente são truncados.

Veja também

Devolver uma aba

Em uma janela separada ou em uma segunda janela completa, clique com o botão direito na aba e escolha Voltar à janela principal. Texto, seleção, visualização, rolagem, histórico e fixação são mantidos. A aba de origem só fecha após a confirmação. Sem ela, a aba e o rascunho permanecem disponíveis. Se a janela principal tivesse de trocar de vault enquanto há nela uma mensagem aberta com dados não salvos, ela não recebe a aba: vem para a frente e avisa, e a aba fica onde está. Os favoritos são atualizados em todas as janelas.

Favoritos de pastas

Adicione um favorito pelo menu de contexto de um arquivo ou pasta. Os favoritos de pastas mostram um ícone próprio: no celular abrem a pasta, no desktop a expandem na árvore. Renomear e mover itens no Plainva também atualiza favoritos de subpastas e arquivos. Destinos ausentes continuam sinalizados; remova esses favoritos explicitamente. Para mudar a ordem, arraste um favorito até o lugar dele na barra lateral — ou pressione Alt+↑ / Alt+↓ na linha em foco; no celular, Organizar favoritos ao lado do título Favoritos abre a lista, onde você arrasta a alça no fim de uma linha.

Ao abrir um cofre, o Plainva importa automaticamente favoritos de arquivos e pastas do Obsidian, inclusive grupos. Tipo e caminho evitam duplicatas. O arquivo do Obsidian permanece intacto. Perfis de configuração transportam as pastas separadamente; um perfil antigo sem esse campo mantém os favoritos de pastas existentes.

Uma lista de pendências sobre suas notas

A visão de tarefas transforma as caixas de seleção das suas notas e os itens do seu banco de tarefas em uma única lista de pendências: Hoje com o que está atrasado no topo, Em breve, Caixa de entrada e Concluídas. Um campo de captura entende uma frase inteira — Ligar para o dentista amanhã 9h30 !! — e mostra o que entendeu antes de salvar qualquer coisa.