Plainva

Notas & Markdown

Última revisão: 2026-07-30

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
okf_version: "0.1"
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. 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).

Dois campos são protegidos: type e okf_version são campos de sistema do OKF gerenciados pelo Plainva — o valor de type é selecionável em uma lista suspensa de tipos conhecidos, enquanto nome/tipo de campo/exclusão ficam travados (contexto: 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
{{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

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. Duas diferenças: as regras são definidas no desktop (o celular só as aplica), e {{weekday:…}} sempre conta a partir de segunda-feira ali, porque a configuração de início da semana ainda não existe no mobile.

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 diárias antigas ainda podem carregá-las: Configurações → Vault → Manutenção → Verificar notas diárias encontra essas notas e mostra cada uma antes de qualquer alteração.

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.

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 de notas diárias configurada, opcionalmente a partir de um modelo.

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

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.