Notas & Markdown

Última revisão: 2026-10-23

Toda nota no Plainva é um arquivo Markdown (.md) comum. Esta página explica como escrever com conforto e o que realmente acaba indo para o arquivo — porque é exatamente isso que torna suas notas portáteis: qualquer editor de texto, o Obsidian ou um diff do git conseguem lê-las.

O princípio central: tudo é texto

Tudo o que você vê no Plainva — texto formatado, tabelas, propriedades, ícones — é armazenado como texto aberto:

---
type: Note
tags: [projeto]
plainva:
  icon: "🚀"
  header_color: "#2f6f6f"
---
# Meu Projeto

Um pensamento em **negrito** com um link para [[Outra Nota]].

- [ ] Primeira tarefa

O bloco entre as linhas --- é o frontmatter (YAML): é ali que ficam as propriedades da nota. Abaixo dele vem o texto Markdown normal. A apresentação específica do Plainva (ícone, cor do cabeçalho) fica agrupada sob a única chave plainva: — outros programas simplesmente a ignoram.

Escrevendo na Visualização ao Vivo

A Visualização ao vivo é o modo padrão: o Markdown é renderizado enquanto você digita, mas continua editável o tempo todo.

O menu de barra

Digite / no início de uma linha para abrir o menu de inserção. Ele é agrupado em seções:

Mais ajudas de escrita

Propriedades (frontmatter)

A seção Propriedades na barra lateral direita mostra o frontmatter da nota como um formulário. Cada propriedade é uma linha: ícone do tipo, nome, valor e, na borda direita, o que a linha permite — um cadeado nos campos protegidos e, ao passar o mouse, Excluir propriedade e o balão de comentário. Os valores são editados no lugar e quebram a linha em vez de serem cortados. Adicionar propriedade cria novas; cada propriedade tem um Tipo de campo:

GrupoTipos
BásicoTexto, Número, Caixa de seleção, Data, Data e hora
EscolhaSeleção, Status, Seleção múltipla
Listas e relaçõesLista, Tags, Relação
Web e contatoURL, E-mail, Telefone

Os tipos de escolha podem ter opções fixas com uma Cor e (para Status) um Grupo/etapa — essas listas de opções são gerenciadas nos bancos de dados (.base), veja Bancos de Dados (.base).

São protegidos os campos de sistema do OKF que o Plainva gerencia: type (o valor é selecionável em uma lista suspensa de tipos conhecidos, nome/tipo de campo/exclusão ficam travados) e — onde notas mais antigas ainda o carregam — okf_version (apenas exibição; desde o OKF 0.2 o campo pertence somente ao index.md raiz). Contexto: OKF.

Status, aviso de desatualização e marca de revisão (OKF 0.2)

Cinco propriedades opcionais do OKF 0.2 permitem que uma nota diga de onde veio e se ainda vale — o Plainva as mostra sem qualquer configuração:

O Plainva define generated e sources somente onde ele mesmo cria notas — no importador, na captura de e-mail e na sincronização de tarefas; o editor nunca sela, e notas existentes não são seladas retroativamente. O contrato dos campos está na Referência do Formato de Arquivo, o contexto em OKF.

Ícone do documento e cor do cabeçalho

Toda nota pode ter um ícone (ao estilo do Notion, acima do título, visível também nas abas e na árvore de arquivos) e uma faixa de cor em largura total:

Modelos

Defina uma Pasta de modelos em Configurações → Vault → Conteúdo e estrutura (Escolher pasta… ao lado do campo permite escolher a pasta diretamente no vault). Depois insira modelos com Ctrl+Alt+T ou o comando de barra Inserir modelo. Os modelos definem por completo o conteúdo dos novos arquivos — inclusive o frontmatter: se um modelo traz seu próprio type, o modelo prevalece. Ao inserir em uma nota existente, o frontmatter do modelo é omitido — apenas o conteúdo é inserido.

Placeholders: os modelos preenchem placeholders nomeados — sem scripts, sem expressões; nada disso executa código.

PlaceholderO que insere
{{title}}O título da nota
{{date}}, {{time}}Data e hora; com seu próprio formato: {{date:DD.MM.YYYY}}
{{date+7}}, {{date-1}}Uma data deslocada, combinável com um formato
{{yesterday}}, {{tomorrow}}O dia anterior, o dia seguinte
{{weekday:monday}}, {{weekday:next friday}}Aquele dia da semana, desta semana ou da próxima; um formato segue os segundos dois-pontos: {{weekday:monday:DD.MM.}}. O dia em que a semana começa depende da sua configuração de calendário
{{daily}}, {{daily+1}}, {{daily-1}}Um link para a nota diária de hoje, de amanhã ou de ontem; com seu próprio rótulo: {{daily+1:Amanhã}}
{{folder}}, {{vault}}A pasta da nota, o nome do vault
{{cursor}}Nenhum texto — marca onde o cursor fica posicionado depois
{{prompt:Label}}, {{prompt:Label|Default}}Pergunta por um texto (exibido como Label)
{{select:Label|A,B,C}}Pergunta com uma lista de opções
{{date_prompt:Label}}Pergunta por uma data
{{selection}}O texto selecionado — ao inserir um modelo
{{clipboard}}A área de transferência — ela chega como uma pergunta pré-preenchida, nunca sem que você perceba na nota
\{{date}}O próprio placeholder, sem resolver

Idioma das datas: os nomes de dias e meses (dddd, MMMM) seguem o idioma do aplicativo — em uma interface alemã, {{date:dddd, D. MMMM YYYY}} escreve Mittwoch, 29. Juli 2026. O nome do arquivo de uma nota diária permanece deliberadamente em inglês: ele precisa corresponder ao formato que o criou, caso contrário o Plainva deixa de encontrar as notas diárias existentes.

Quando um modelo pergunta algo, o Plainva faz todas as perguntas em um único diálogo antes de a nota ser escrita — seja ao inserir, seja ao criar; cancelar não cria nada. Só nas notas criadas em segundo plano (na sincronização de tarefas, por exemplo) nada é perguntado: ali as respostas ficam vazias. Um placeholder que o Plainva não conhece permanece visível — assim, um erro de digitação parece um erro de digitação.

No celular o mesmo mecanismo funciona: os placeholders são preenchidos, as perguntas de um modelo chegam juntas em uma única folha (cancelar não cria nada), e as regras pasta → modelo e tipo de nota → modelo também se aplicam ali — então uma nota em Projekte/ começa da mesma forma em ambos os dispositivos. As regras também podem ser definidas no celular (Configurações → Conteúdo e estrutura), e {{weekday:…}} segue ali a configuração Início da semana em Configurações → Aparência; cada dispositivo mantém a sua.

Configurações próprias do modelo: um modelo pode carregar configurações válidas só para ele — que suas tarefas fiquem fora da visão Tarefas, ou a quais bancos de dados ele pertence. Uma nota criada a partir dele não as herda. Notas que você criou a partir de um modelo até a versão 0.8.5 ainda podem carregá-las; a FAQ explica como encontrá-las.

Modelos por pasta: em Configurações → Vault → Conteúdo e estrutura → Modelos você associa uma pasta a um modelo — toda nova nota criada ali parte então dele, sem que você escolha nada. A associação também cobre subpastas; quando várias correspondem, vence o caminho mais longo (Projects/Clients vence Projects). Você associa um modelo a um tipo de nota da mesma forma; aplica-se quando nenhuma regra de pasta cobre a nota — a pasta vence o tipo. Nova nota a partir de modelo … (clique com o botão direito na árvore de arquivos, a paleta de comandos ou o alternador rápido) permite escolher um explicitamente — isso vence qualquer associação. As associações vivem nas configurações, não nas notas, e viajam para seus outros dispositivos através da sincronização das configurações.

Criar modelos funciona de qualquer lugar: a paleta de comandos (Ctrl+P) oferece Criar novo modelo (um modelo novo abre para edição) e Salvar a nota atual como modelo (copia a nota aberta para a pasta de modelos). Modelos são arquivos Markdown comuns — edite, renomeie ou exclua-os diretamente na árvore de arquivos. No telefone, os dois também estão na paleta de comandos (> no campo de busca); para o segundo, abra-a pelo menu ⋮ da nota → Comandos.

Notas diárias

Abrir nota diária (barra lateral) ou um clique no Calendário cria a nota de hoje usando seu formato de data na pasta base de notas diárias configurada, opcionalmente a partir de um modelo.

Uma nota diária também pode conter um diário: entradas curtas com hora (- 14:05 Text) sob o título Journal, escritas com Ctrl+Shift+J ou Entrada de diário e lidas ao longo de todos os dias na visualização do diário. São linhas de lista comuns — veja Diário.

Tarefas, fórmulas, diagramas e notas de rodapé

Texto da direita para a esquerda

Árabe, hebraico, persa e as demais escritas da direita para a esquerda são compostos automaticamente da direita para a esquerda — parágrafo por parágrafo, sem nenhuma configuração para ligar. Cada parágrafo, título, item de lista, linha de citação e célula de tabela segue a primeira letra depois da sintaxe Markdown: um parágrafo que começa com uma palavra árabe corre a partir da direita, um que começa com uma palavra latina a partir da esquerda, e uma mesma nota pode misturar os dois. Marcadores, caixas de seleção, a barra de citação e o recuo vão para a direita junto com o texto; o x de - [x] não conta como palavra, então uma tarefa concluída continua à direita. Uma linha sem letras (um número, um item de lista novo e vazio) mantém a direção da linha de cima.

Imprimir e salvar como PDF

O menu ⋮ do editor e a paleta de comandos (Ctrl+P) têm Imprimir / Salvar como PDF…: a impressão sempre usa a visualização de leitura (a partir do modo ao vivo/código-fonte, o Plainva muda para ela primeiro). No diálogo do sistema, você pode escolher “Salvar como PDF” em vez de uma impressora.

Exportando uma nota

Abrindo uma nota em outro editor

Suas notas são arquivos .md comuns, então qualquer editor Markdown consegue abri-las. O menu ⋮ do editor tem Abrir no aplicativo padrão, que entrega a nota atual ao aplicativo que o seu sistema usa para arquivos Markdown (Byword, MacDown, VS Code e assim por diante). O Plainva continua observando o arquivo, então as edições feitas lá aparecem aqui automaticamente.

Imagens e anexos

E o Obsidian?

Tudo permanece Markdown padrão com frontmatter padrão. O Obsidian abre os arquivos por completo; ele mostra a chave agrupada plainva: como um objeto não editável no painel de propriedades — isso é intencional e inofensivo.

Veja também

Formatar uma seleção

Quando uma seleção abrange várias linhas, negrito, itálico, tachado, destaque e código em linha são aplicados separadamente a cada linha não vazia. Prefixos de lista, citação, título e tarefa ficam fora dos marcadores. Links continuam em uma linha porque um rótulo multilinha não é Markdown portátil.

Um título ATX e uma tarefa GFM são tipos de bloco alternativos. O Plainva não grava uma combinação inválida. A formatação em linha funciona nos dois; use - [ ] **Tarefa importante** para destacar o título.

Incorporar seções e blocos

![[Nota#Título]] exibe a seção e seus subtítulos até o próximo título do mesmo nível ou superior. ![[Nota#^block-id]] exibe o parágrafo, item de lista ou bloco anterior a um ID em uma linha separada. Um link comum [[Nota#^block-id]] também salta até esse ponto no modo de leitura.

Para títulos repetidos, use uma hierarquia única (#Projeto#Resultado) ou uma âncora numerada (#resultado-1). Destinos ausentes ou ambíguos mostram uma mensagem, e a origem continua acessível. O aninhamento é limitado; exemplos de código não executam incorporações. No telefone, seções e blocos não são cortados nas quatro linhas da prévia geral de notas. Os arquivos existentes permanecem inalterados.

Usar listas

Um item de lista só é recolhido após concluir um toque ou clique no marcador. Arrastar, rolar, cancelar o contato ou usar vários dedos não o recolhe. O recuo permanece estável ao trocar a fonte ou usar janelas estreitas; o texto-fonte, as tabulações e a posição do cursor são preservados.

Barras de seleção visíveis

A barra de formatação acompanha a seleção durante a rolagem e mantém uma margem das bordas. Quando falta espaço, muda para o outro lado da seleção ou distribui os botões em mais linhas. Na leitura móvel, rótulos longos se tornam ícones com nomes acessíveis quando necessário; Copiar, Selecionar tudo e as ações disponíveis de edição ou comentários continuam acessíveis.

Completar propriedades

Ao adicionar uma propriedade, nomes conhecidos aparecem com tipo e frequência. Nomes existentes e reservados são excluídos. O tipo da base correspondente tem prioridade, seguido pelo tipo indexado e pelo registro local. Sugestões de texto e listas vêm da pasta da nota; “Pesquisar em todo o cofre” amplia o escopo. As listas oferecem valores individuais. Opções definidas pela base permanecem exclusivas, mesmo quando a lista está vazia. A entrada livre continua disponível; apenas uma edição confirmada altera a nota. Textos e listas mantêm seu tipo nas propriedades e células de bases, no desktop e no celular.

Abrir imagem

Abrir imagem está disponível para imagens locais na leitura, prévia e menu de contexto. No visualizador móvel, use dois dedos, toque duplo ou botões; Redefinir zoom mostra a imagem inteira. Voltar retorna à nota. Pressionar a imagem incorporada mantém as ações do sistema e a seleção de regiões para comentários.