Do Obsidian ao site: o Obsidian

Nesta página você prepara o vault: as pastas, quatro configurações, um modelo de nota e o repositório no GitHub. Nenhum plugin da comunidade é obrigatório. O guia usa só o Templates, que já vem no Obsidian.

1. Instalar e criar o vault

Baixe o Obsidian em obsidian.md/download (Windows, macOS ou Linux). Ele é gratuito para qualquer uso e não pede conta.

Na primeira abertura, escolha Create new vault, dê um nome (no guia, Meu vault) e escolha onde guardar. Se você já tem um vault, use o seu: nada do que vem a seguir mexe nas notas que já existem.

2. Criar as pastas

Crie três pastas na raiz do vault:

Pasta	Para quê
blog/	As notas publicadas. Tudo o que está aqui vai para o site
rascunhos/	Os textos em andamento
modelos/	O modelo de nota de artigo

A pasta blog/ não tem subpastas de texto. O template transforma o caminho dentro dela no endereço da página, então uma nota em blog/viagens/japao.md iria para /blog/viagens/japao/. Deixe as notas direto em blog/, e as imagens em blog/images/.

3. Ajustar links e imagens

Em Settings → Files and links, mude quatro opções:

Opção	Valor	Por quê
Use [[Wikilinks]]	desligado	O site não entende o formato [[nota]] e o mostra como texto. Desligado, o Obsidian cria links e imagens no formato Markdown
New link format	Relative path to file	O caminho da imagem passa a ser relativo à nota (images/foto.png), que é o que o site procura
Automatically update internal links	ligado	Ao mover uma nota ou imagem, o Obsidian corrige os links que apontam para ela
Default location for new attachments	In subfolder under current folder, com o nome images	Uma imagem colada numa nota vai para a pasta images/ ao lado da nota

Com isso, colar uma imagem numa nota do blog/ cria o arquivo em blog/images/, com um nome que começa por Pasted image seguido da data, e escreve na nota um link como este (nome simplificado):

![](images/Pasted%20image%2020261015.png)

O template aceita esse link como está, com os espaços codificados.

Uma imagem colada num rascunho vai para rascunhos/images/. Quando o texto for para o blog, mova a nota e as imagens dela: a nota para blog/ e as imagens para blog/images/. O Obsidian corrige os links nos dois movimentos.

4. Nome da nota e endereço

O nome do arquivo vira o endereço da página. O template troca maiúsculas por minúsculas e espaços por hífens:

Nota	Endereço
blog/Meu Primeiro Artigo.md	/blog/meu-primeiro-artigo/
blog/segundo-artigo.md	/blog/segundo-artigo/
blog/Ação Rápida.md	/blog/ação-rápida/

Os acentos continuam no endereço. Para um endereço sem acento, dê à nota um nome sem acento, ou mantenha o nome e escolha o endereço com a propriedade slug:

slug: acao-rapida

Renomear uma nota já publicada muda o endereço dela, e quem tinha o link antigo encontra uma página de erro.

5. Criar o modelo de artigo

O template pede três propriedades em cada post: title, description e pubDate. Um modelo de nota as traz prontas.

1. Em Settings → Core plugins, ligue Templates.
2. Em Settings → Templates, em Template folder location, escolha modelos.
3. Crie a nota modelos/Artigo.md com este conteúdo:

---
title: "{{title}}"
description: 
pubDate: {{date}}
---

Para começar um texto, crie uma nota em rascunhos/, dê o nome e use Insert template (o ícone na barra lateral, ou a paleta de comandos). O Obsidian troca {{title}} pelo nome da nota e {{date}} pela data de hoje, no formato AAAA-MM-DD. A description fica para você escrever. Se ela ficar vazia, o site recusa a nota na hora de publicar, o que serve de lembrete.

Para ter o que ver nas próximas etapas, crie já uma nota em blog/, por exemplo blog/Meu primeiro artigo.md, insira o modelo, preencha a description e escreva um parágrafo.

Duas propriedades opcionais do template:

Propriedade	Exemplo	O que faz
heroImage	images/capa.jpg	Imagem de capa, no topo do post e na lista
updatedDate	2026-10-20	Data da última revisão, mostrada como “Last updated on” abaixo da data de publicação

6. Colocar o vault no GitHub

A publicação automática parte do GitHub, então o vault precisa estar num repositório lá. Use um repositório privado: ele guarda o vault inteiro, inclusive as notas que não vão para o site.

Com o GitHub Desktop:

1. File → Add local repository e escolha a pasta do vault.
2. Como a pasta ainda não é um repositório, o GitHub Desktop oferece criar um. Aceite.
3. Publish repository, com Keep this code private marcado.

No dia a dia, enviar o vault é escrever uma frase sobre a mudança, clicar em Commit to main e depois em Push origin.

Para enviar sem sair do Obsidian, existe o plugin da comunidade Obsidian Git: o comando Commit-and-sync grava, baixa e envia as mudanças. Ele é opcional e precisa do Git instalado no computador.