Plugin Templater no Obsidian: Automatize as suas notas (Guía de configuração 2026)

Os modelos não servem apenas para poupar toques no teclado. Servem para eliminar a fricção que o impede de criar uma nota em primeiro lugar. Quando abrir uma nota diária em branco significa decidir um formato de data, reescrever os mesmos cabeçalhos e procurar o registo de ontem, cria menos notas. Quando a nota se constrói a si mesma no momento em que a abre, limita-se a escrever.

Essa é toda a promessa do plugin Templater. Ele pega na funcionalidade nativa do Obsidian confusamente chamada “Templates” e transforma-a de uma simples ferramenta de procurar e substituir num pequeno motor de automação: datas dinâmicas, perguntas interativas, posicionamento do cursor e notas que aplicam o seu próprio modelo no instante em que são criadas. Não precisa de ser programador para aproveitar a grande maioria do seu valor, e as partes que parecem intimidadoras (a sintaxe <% %>) fazem sentido em cerca de dez minutos.

Este guia leva-o desde uma instalação limpa até uma estrutura totalmente automatizada onde novas notas numa pasta aplicam o seu modelo sem que precise de mover um dedo. Eis o que vamos cobrir:

• Em que difere o Templater do plugin nativo Templates e qual deve manter
• Como instalar, ativar e confirmar que o Templater está a funcionar
• Como definir e organizar a sua pasta de modelos
• Modelos estáticos vs. dinâmicos e a diferença entre <% %> e <%* %>
• A sintaxis fundamental que vai realmente utilizar (tp.date, tp.file, tp.system)
• Um modelo completo de nota diária com navegação anterior/seguinte
• Como aplicar modelos automaticamente a cada nova nota numa pasta
• Modelos do mundo real prontos a colar, além dos erros mais comuns

Templater vs. plugin nativo Templates: de qual precisa realmente?

Para qualquer elemento que vá além de inserir uma data estática, vai querer o Templater. O Obsidian inclui um plugin nativo literalmente chamado “Templates” que faz uma substituição básica, trocando {{date}}, {{time}} e {{title}} por valores fixos quando insere um modelo. É apenas isso. Sem lógica, sem perguntas, sem cálculos.

O Templater é um plugin da comunidade que substitui e expande enormemente essa ideia. As diferenças que importam:

• Sintaxe: o plugin nativo utiliza {{date}}; o Templater utiliza <% tp.date.now() %> e pode executar JavaScript.
• Valores dinâmicos: o Templater calcula valores no momento da inserção, como “a data de ontem” ou “o título do ficheiro formatado como dia da semana”.
• Entrada interativa: o Templater pode pausar e fazer-lhe uma pergunta (tp.system.prompt) ou exibir uma lista de opções (tp.system.suggester).
• Predefinições por pasta: o Templater pode aplicar automaticamente um modelo a qualquer nota criada numa determinada pasta.
• Posicionamento do cursor: o Templater coloca o seu cursor exatamente onde deseja começar a escrever.

Deve desativar o plugin nativo Templates? Se executar ambos com configurações sobrepostas, obterá um comportamento confuso de dupla substituição e conflitos nas pastas de modelos. A recomendação clara: mantenha o Templates nativo ativo apenas se algum outro plugin depender dele, mas direcione todo o seu trabalho real para o Templater e deixe de criar modelos com a sintaxe {{ }}. A maioria dos utilizadores avançados desativa o Templates nativo completamente após a transição, e nada se estraga. Para compreender como os modelos se encaixam num sistema Obsidian, o nosso guia para começar com modelos no Obsidian estabelece as bases.

Nota: O plugin nativo chama-se “Templates” (plural, integrado). O plugin da comunidade chama-se “Templater” (desenvolvido por SilentVoid13). Os nomes quase idênticos são a principal fonte de confusão para iniciantes.

Como instalar e ativar o Templater?

Instale o Templater a partir do navegador de plugins da comunidade do Obsidian em menos de um minuto. O caminho exato:

1. Abra Settings → Community plugins.
2. Se vir um aviso de “Restricted mode” ou “Safe mode”, clique primeiro em Turn on community plugins.
3. Clique em Browse, e depois pesquise por Templater.
4. Escolha o desenvolvido por SilentVoid13 (é de longe o mais descarregado).
5. Clique em Install, e depois em Enable.

Dica: Versões antigas do Obsidian chamavam a isto “Safe Mode” e ocultavam o botão Browse até o desativar. Se não consegue encontrar os plugins da comunidade, esse botão é o que o está a bloquear.

Confirme que está a funcionar. Após ativar, deverá ver um pequeno ícone do Templater na barra lateral esquerda (um par de parênteses angulares). Abra a paleta de comandos com Ctrl/Cmd + P e escreva “Templater”: deverá ver comandos como Templater: Open insert template modal e Templater: Replace templates in the active file. Se eles aparecerem, está pronto.

Como definir a sua pasta de modelos e organizá-la?

O Templater necessita de uma pasta para tratar como a sua biblioteca de modelos, configurada em Settings → Templater → Template folder location. Até definir isto, o Templater não sabe quais as notas que são modelos.

Faça o seguinte:

1. Crie uma pasta dedicada no seu vault chamada Templates (ou _Templates se quiser que fique no topo da lista).
2. Aceda a Settings → Templater → Template folder location e selecione essa pasta.
3. Coloque cada modelo dentro dela como uma nota Markdown normal — o nome do ficheiro torna-se o nome que verá na lista de inserção.

À medida que a sua biblioteca crescer, organize-a com subpastas para que a janela de inserção permaneça fácil de navegar:

• Templates/Daily/
• Templates/Meetings/
• Templates/Projects/
• Templates/Snippets/ (pequenos blocos reutilizáveis)

Dica: Adicione um prefixo ao nome dos ficheiros de modelo com o seu tipo, como meeting-1on1.md ou project-new.md. Com vinte modelos, uma lista alfabetizada com prefixos é muito mais rápida de analisar do que nomes criativos.

Modelos estáticos vs. dinâmicos: qual é a diferença?

Um modelo estático é texto fixo que sai idêntico de todas as vezes; um modelo dinâmico calcula valores no momento em que o insere. Uma nota de reunião estática diz sempre “## Participantes”. Uma dinâmica pode colocar a data de hoje, extrair o título do ficheiro ou perguntar quem esteve presente — um resultado diferente de cada vez.

O comportamento dinâmico provém de dois delimitadores, e confundi-los é o erro número um dos iniciantes:

• <% %> é um comando de saída. O que quer que avalie é impresso na sua nota. <% tp.date.now() %> escreve a data.
• <%* %> (note o asterisco) executa JavaScript sem imprimir. Utilize-o para lógica, variáveis e ciclos. Nada é escrito a menos que o indique explicitamente.

Regra geral: se deseja que um valor apareça na nota, utilize <% %>. Se estiver a fazer lógica ou configurações, utilize <%* %>. Um erro comum é envolver uma expressão que produz valor em <%* %> e depois perguntar-se por que razão nada é exibido.

Hoje é <% tp.date.now("YYYY-MM-DD") %>

<%* const greeting = tp.date.now("HH") < 12 ? "Bom dia" : "Boa tarde" %>
<% greeting %>, vamos ao trabalho.

A primeira linha imprime uma data. O bloco <%* %> calcula uma variável silenciosamente, e o <% greeting %> final imprime-a. Essa separação (calcular em silêncio, imprimir explicitamente) é o modelo mental fundamental.

Qual é a sintaxe básica do Templater que vai realmente utilizar?

Pode construir 90% dos modelos úteis utilizando apenas três famílias de funções: tp.date, tp.file e tp.system. Eis o conjunto prático.

Datas — tp.date.now() devolve a data atual, e você controla o formato e o deslocamento:

• <% tp.date.now("YYYY-MM-DD") %> → 2026-06-05
• <% tp.date.now("YYYY-MM-DD", -1) %> → ontem (o segundo argumento é um deslocamento em dias)
• <% tp.date.now("YYYY-MM-DD", 1) %> → amanhã
• <% tp.date.now("dddd") %> → o nome do dia da semana, como Sexta-feira

Informação do ficheiro — extrair metadados sobre a própria nota:

• <% tp.file.title %> → o título da nota atual
• <% tp.file.creation_date("YYYY-MM-DD HH:mm") %> → quando o ficheiro foi criado
• <% tp.file.cursor() %> → onde o cursor fica após a inserção (utilize tp.file.cursor(1), tp.file.cursor(2) para alternar entre vários pontos)

Entrada interativa — tp.system faz uma pausa e pergunta-lhe:

• Texto livre: <% tp.system.prompt("Título da reunião?") %>
• Escolher de uma lista: <% tp.system.suggester(["Baixa", "Média", "Alta"], ["Baixa", "Média", "Alta"]) %> — a primeira lista é o que é exibido, a segunda é o valor devolvido.

---
priority: <% tp.system.suggester(["Baixa","Média","Alta"], ["Baixa","Média","Alta"]) %>
created: <% tp.date.now("YYYY-MM-DD") %>
---
# <% tp.system.prompt("Sobre o que é esta nota?") %>

<% tp.file.cursor() %>

Ao inserir isso, o Templater pede uma prioridade, solicita um título, regista a data de hoje e posiciona o cursor no corpo da nota. Sem ter de escrever nada disso manualmente. Assim que as suas notas tiverem metadados (frontmatter) consistentes como estes, encaixam perfeitamente num sistema mais amplo — consulte o nosso guia completo de gestão de tarefas no Obsidian para ver onde isso conduz.

Como criar um modelo de nota diária?

O grande poder de um modelo de nota diária é transformar o próprio título da nota num cabeçalho formatado e em hiperligações de navegação para os dias anteriores e seguintes. O truque: o nome de ficheiro da sua nota diária já é uma data (como 2026-06-05), pelo que tp.file.title dá ao Templater uma sequência de data para trabalhar através do Moment.js.

Um modelo de nota diária completo para copiar e colar:

---
date: <% tp.file.title %>
type: daily
---
# <% moment(tp.file.title, "YYYY-MM-DD").format("dddd, D [de] MMMM [de] YYYY") %>

[[<% moment(tp.file.title, "YYYY-MM-DD").subtract(1, "days").format("YYYY-MM-DD") %>|← Ontem]] | [[<% moment(tp.file.title, "YYYY-MM-DD").add(1, "days").format("YYYY-MM-DD") %>|Amanhã →]]

## Foco
- <% tp.file.cursor() %>

## Tarefas
- [ ]

## Registo

## Notas

O que acontece: o H1 reformata o nome do ficheiro num cabeçalho com o dia da semana. As duas hiperligações utilizam .subtract e .add do Moment.js para criar wikilinks para as notas do dia anterior e seguinte, permitindo-lhe navegar para trás e para a frente no seu diário. O cursor fica no seu primeiro ponto de foco, pronto a escrever.

Ligue-o. Aponte a sua ferramenta de criação de notas para este modelo:

• Utilizando o plugin nativo Daily notes: Settings → Daily notes → Template file location → selecione este modelo.
• Utilizando o plugin da comunidade Calendar: respeita as configurações do modelo de Daily notes, pelo que clicar numa data aplica-o automaticamente.

Nota: O erro clássico — se criar uma nota diária escrevendo um ficheiro novo manualmente em vez de utilizar o fluxo do Daily notes/Calendar, o modelo não será aplicado. Para uma cobertura mais aprofundada de fluxos de trabalho de diários, consulte o nosso guia completo sobre notas diárias no Obsidian.

Como aplicar automaticamente um modelo a cada nova nota numa pasta?

A funcionalidade Folder Templates do Templater aplica um modelo escolhido a qualquer nota criada dentro de uma pasta associada, sem qualquer inserção manual. Este é o benefício que a maioria dos tutoriais ignora: um sistema onde as notas aplicam o seu próprio modelo.

Configure isto em duas partes:

1. Ative o gatilho. Aceda a Settings → Templater e ative Trigger Templater on new file creation. Sem isto, os modelos de pasta simplesmente não são executados — é a razão mais comum para “não estar a funcionar”.
2. Associe a pasta. Em Settings → Templater → Folder Templates, adicione uma associação como Meetings → Templates/Meetings/meeting-default.md. Agora, cada nota criada dentro de /Meetings executa esse modelo instantaneamente.

Alguns avisos que vale a pena saber de antemão:

• O gatilho só é ativado na criação, não ao abrir ou editar uma nota existente.
• Se um modelo de pasta e o modelo de Daily notes tentarem utilizar a mesma nota, pode ocorrer um conflito — mantenha as suas notas diárias numa pasta que não esteja associada em Folder Templates.
• “Trigger on new file creation” afeta todos os ficheiros novos, pelo que associações muito amplas (como associar todo o vault) podem surpreendê-lo. Associe pastas específicas.

Este é o tipo de automação que faz com que um vault pareça um sistema de produtividade real em vez de um conjunto de ficheiros Markdown. Se desejar esse sistema pré-construído, o modelo de produtividade do Obsibrain inclui estas associações de modelos de pasta já configuradas para que reuniões, projetos e notas diárias se autopovoem desde o primeiro dia.

Modelos práticos do mundo real (e uma forma mais rápida de os obter)

Apresentamos três modelos que pode colocar na sua pasta Templates agora mesmo. Cada um combina a sintaxe das secções anteriores.

Nota de reunião — pede os participantes e disponibiliza uma secção de tarefas pendentes:

---
type: meeting
date: <% tp.date.now("YYYY-MM-DD") %>
attendees: <% tp.system.prompt("Participantes (separados por vírgula)") %>
---
# <% tp.system.prompt("Título da reunião") %>

## Agenda
- <% tp.file.cursor() %>

## Notas

## Itens de ação
- [ ]

Nota de projeto — define o metadado de estado a partir de uma lista de opções e estrutura os marcos:

---
type: project
status: <% tp.system.suggester(["Planeamento","Ativo","Em pausa","Concluído"], ["Planeamento","Ativo","Em pausa","Concluído"]) %>
created: <% tp.date.now("YYYY-MM-DD") %>
---
# <% tp.file.title %>

## Objetivo
<% tp.file.cursor() %>

## Marcos
- [ ]

## Próximas ações
- [ ]

Nota diária — o modelo de diário com navegação da secção anterior, reutilizado tal como está.

Para leitores que queiram ir mais longe, o Templater também suporta scripts de utilizador através de tp.user.* — funções JavaScript reutilizáveis que guarda numa pasta de scripts e chama a partir de qualquer modelo. Isso é extremamente poderoso para elementos como gerar automaticamente uma revisão semanal a partir das suas notas diárias. Ligar notas com modelos através de retroenlinks é o que as transforma numa rede real — o nosso guia sobre hiperligações no Obsidian explica como fazer com que essas ligações contem.

No entanto, eis o compromisso honesto: construir, formatar e depurar uma biblioteca completa de modelos (reuniões, projetos, notas diárias, semanais, acompanhamento de hábitos) é um projeto em si mesmo. Erros de sintaxe em YAML, falhas de formatação no Moment.js e conflitos de pastas consomem horas. Se prefere o resultado em vez do processo de construção, o Obsibrain oferece um conjunto preparado de modelos e painéis já configurados e testados, para que passe diretamente a utilizá-los. E se pretende apenas alguns padrões para copiar manualmente, o nosso artigo sobre 10 exemplos essenciais de modelos no Obsidian é uma biblioteca de arranque rápido.

Problemas comuns e resolução de erros

A maioria dos problemas do Templater deve-se a alguns erros recorrentes. Verifique estes primeiro:

• Conflito com o Templates nativo. Se os modelos se comportarem de forma estranha, confirme que está a inserir através do Templater e não do plugin Templates nativo. Executar ambos com a mesma pasta de modelos causa duplo processamento.
• O modelo não é ativado na criação manual. Os modelos de pasta só funcionam ao criar ficheiros por meios normais, e apenas quando Trigger Templater on new file creation está ativo. Escrever manualmente um nome de ficheiro numa pasta não associada não aplica nada.
• Erros de impressão em <% %> vs. <%* %>. Se um valor não aparecer, provavelmente utilizou <%* %> (silencioso) quando pretendia <% %> (imprimir). Se obtiver um “undefined” ou um erro de sintaxis, é provável que tenha tentado imprimir a partir do interior de um bloco de lógica.
• O modelo de pasta sobrescreve a sua nota diária. Quando tanto um modelo de pasta como o modelo de Daily notes são aplicados à mesma nota, o comportamento torna-se imprevisível. Separe as suas pastas.
• Erros nos códigos de formatação do Moment.js. Os códigos diferenciam maiúsculas de minúsculas: YYYY (ano) não é yyyy, MM (mês) não é mm (minutos) e DD (dia) não é dd. Uma opção incorreta é a causa habitual para uma data que aparece desformatada.

Perguntas Frequentes

O Templater é melhor do que o plugin Templates integrado do Obsidian? Sim, para qualquer elemento dinâmico. O plugin Templates nativo apenas realiza uma substituição fixa de valores como {{date}} e {{title}}. O Templater adiciona datas calculadas, perguntas interativas, posicionamento do cursor, automação de pastas e JavaScript. A única razão para manter o plugin nativo é se verdadeiramente nunca precisar de nada além de um carimbo de data estático.

Preciso de saber JavaScript para utilizar o Templater? Não, não para cerca de 90% do uso real. tp.date, tp.file e tp.system.prompt/suggester cobrem notas diárias, reuniões, projetos e a maioria dos modelos diários sem escrever uma linha de código personalizado. O JavaScript só se torna necessário para scripts avançados tp.user.*.

Por que razão o meu modelo do Templater não é aplicado a novas notas? Quase sempre se deve a uma de duas razões: não ativou Trigger Templater on new file creation em Settings → Templater, ou criou a nota fora do fluxo que aplica modelos (para notas diárias, isso significa utilizar o plugin Daily notes/Calendar em vez de criar manualmente o ficheiro).

O Templater pode ser executado automaticamente sem eu inserir um modelo manualmente? Sim. O Folder Templates aplica um modelo a cada nota criada numa pasta associada, e as configurações do Daily notes/Calendar aplicam o seu modelo diário ao clicar numa data. Combinado com o gatilho de criação de novos ficheiros, as suas notas aplicam o seu próprio modelo.

Crie o hábito

O Templater traz retorno mais rápido quando deixa de encarar os modelos como algo que insere e passa a tratá-los como a forma predefinida de cada nota. Instale o plugin, defina a sua pasta de modelos, crie um modelo de nota diária e configure uma pasta associada para que um tipo de nota se construa sozinho. O primeiro contacto com uma nota que já está estruturada quando a abre é o que costuma cativar os utilizadores.

A partir daí, adicione modelos um a um à medida que notar que volta a escrever os mesmos cabeçalhos. Em uma ou duas semanas terá uma pequena biblioteca que elimina a fricção todos os dias — e se prefere saltar a construção completamente, um modelo de produtividade pronto a usar levá-lo-á lá numa tarde.