41 pontos por GN⁺ 2025-04-29 | 11 comentários | Compartilhar no WhatsApp
  • Escreva os textos localmente com Obsidian e publique um blog pessoal de forma rápida e gratuita com a combinação Hugo + tema Bear Blog + Cloudflare Pages
  • O controle de versão via GitHub e a implantação automática tornam a manutenção prática. Basta escrever, salvar e fazer commit para publicar imediatamente
  • A configuração inicial exige um pouco de conhecimento de desenvolvimento, mas depois o fluxo de trabalho fica muito simples
  • Indicado para quem procura uma forma leve e sustentável de manter um blog

Configuração detalhada

  • Use Obsidian para escrever todos os textos
    • Como os arquivos são salvos localmente, todos os dados ficam sob seu controle
    • O tema Minimal oferece uma interface limpa e sem distrações
    • Com iCloud, é possível sincronizar sem limites entre vários dispositivos (também funciona com Dropbox e Google Drive)
  • Publicação
    • Hugo: gerador de sites estáticos ultrarrápido
    • Tema Bear Blog: tema de blog minimalista e rápido
    • GitHub + Cloudflare Pages: permitem publicar um site gratuitamente
    • Vantagens: sem assinatura, sem dependência de fornecedor, sem risco de mudanças na política da plataforma

Configuração do sistema

  • Depois de instalar o Hugo, crie um novo site
    hugo new site myblog  
    cd myblog  
    
  • Adicione o tema Bear Blog
    git init  
    git submodule add https://github.com/janraasch/hugo-bearblog.git themes/hugo-bearblog  
    
  • Configure o arquivo config.toml para usar o tema Bear Blog
    theme = 'hugo-bearblog'  
    
  • Conecte o Obsidian ao Hugo
    • Escreva os posts na pasta content/blog do Hugo
    • No Obsidian, use o recurso "Open folder as vault" para abrir essa pasta
    • Assim, os textos escritos no Obsidian passam a ficar ligados diretamente aos posts do site em Hugo
  • Adicione, no topo dos textos escritos no Obsidian, um template de Front Matter para o Hugo
    +++  
    title= "Your Post Title"  
    date= YYYY-MM-DD  
    tags= ["post"]  
    draft= true  
    +++  
    
  • Quando estiver pronto para publicar, altere draft para false
  • Use o servidor local do Hugo para visualizar o texto no navegador
    hugo server -D  
    
  • Crie um novo repositório no GitHub e conecte o projeto local
    git remote add origin https://github.com/yourusername/yourblog.git  
    git add .  
    git commit -m "Initial commit"  
    git push -u origin main  
    
  • Depois de se cadastrar no Cloudflare, crie um projeto no Pages
    • Conecte o repositório do GitHub e aplique as seguintes configurações de build
      • Comando de build: hugo --minify
      • Diretório de saída: public

Fluxo de publicação

  • Escreva o post no Obsidian
  • Altere draft: true para draft: false no template de Front Matter
  • Faça commit e push para o GitHub
    git add . git commit -m "Publish new post" git push
  • O Cloudflare Pages detecta automaticamente as mudanças, recompila o site e aplica tudo em 1 a 2 minutos

11 comentários

 
codject 2025-05-05

Eu também administro um blog com Hugo.
Depois de escrever os textos no Obsidian, uso um método em que o push para o repositório no GitHub aciona a hospedagem no Cloudflare Pages.
E aí ainda adiciono o serviço de busca da Algolia; sempre que escrevo um novo post, criei um arquivo sh para fazer a indexação, colocando nele todos os comandos encadeados, como git, indexação e afins, e publico o texto executando o comando sh.

Uso principalmente o Obsidian pela diversão de às vezes reunir e revisar os textos que escrevi na visualização em grafo.

 
sungchi 2025-04-30

Eu também vinha fazendo de forma parecida, mas agora estou escrevendo diretamente no repositório do github.com. (usando o recurso em que o GitHub Pages faz o build do Jekyll automaticamente)

https://plan9.kr/

 
jk34011 2025-05-02

Nossa, foi você que fez o Text Battle?
Vi isso na comunidade há um tempo e achei bem divertido hahaha, prazer em te ver por aqui

 
zxshinxz 2025-04-29

Eu também estou criando um blog com Hugo, então foi bom ver isso!
Também cheguei a pensar em usar o Obsidian como editor principal, mas se você estiver em um ambiente com computador, acho que o VSCode é melhor.
Como as mudanças são refletidas em milissegundos, acabei não sentindo muita necessidade do Obsidian.

 
halfenif 2025-04-29

Não vejo motivo para conectar o Hugo ao Obsidian.

Se você usa Hugo, tenho a impressão de que o VSCode parece mais natural.

 
bobross0 2025-04-29

Isso é realmente muito interessante.

 
gdaw3440 2025-04-29

O plugin digital garden também é prático.

 
haejuk99 2025-04-29

Obrigado por compartilhar. Estou começando a usar o Obsidian agora, então acho que vou tentar usá-lo junto também.

 
ethanhur 2025-04-29

Obrigado pelas boas informações. Tenho usado bastante o Obsidian ultimamente, e acho que é uma combinação que combina bem comigo.

 
tequila 2025-04-29

Como há poucos dias eu justamente criei um blog com Hugo, fiquei muito feliz de ver esse conteúdo.
Eu configurei para fazer o deploy no GitHub Pages quando faço push e estou usando assim. rsrs
Também gosto muito do Obsidian, mas recomendo usar no VSCode uma extensão chamada Front Matter.
Ela oferece uma função de CMS simples; não é totalmente perfeita, mas achei bem razoável.

 
GN⁺ 2025-04-29
Comentários no Hacker News
  • Essa stack oferece controle total: sem assinatura, sem dependência de fornecedor, sem risco de a plataforma desaparecer ou mudar de política
    • O autor mostra, por meio disso, que o significado de "controle total" mudou bastante
  • Operar um blog estático é um dos cenários mais fáceis de hospedar por conta própria
  • Parece estranho falar em "controle total" e "sem risco de a plataforma desaparecer" enquanto se depende da camada gratuita de duas empresas externas
  • Espero o próximo post do blog daqui a um ano: "como reconstruí meu blog"
  • Pesquisar no Google por "como fiz meu blog com [next.js/Gatsby etc.]" é um passatempo divertido
  • Há centenas de blogs de desenvolvedores que não têm nenhuma postagem além do artigo anunciando como o blog foi construído
  • A escolha do Obsidian parece um pouco estranha nesse contexto, mas interessante
    • Em vez de abrir uma subpasta do projeto Hugo no Obsidian, dá para abrir tudo no VSCode ou em uma IDE semelhante
    • A experiência de edição de Markdown no Obsidian é diferente da de uma IDE comum
    • Se você prefere o conjunto de recursos do Obsidian, a escolha faz sentido
    • Um dos pontos fortes do Markdown é ser compatível com vários editores
  • Tenho uma configuração parecida, mas escrevi um plugin personalizado do Obsidian que comprime assets/converte frontmatter/empacota tudo e faz push para o repositório do blog no Github
  • O Github usa Pelican para converter em HTML e fazer deploy em um VPS
    • Dá para ter facilmente uma interface WYSIWYG
    • O VSCode é suficiente para blogar em Markdown
    • O Hugo compila as páginas ao salvar, então dá para iterar rapidamente
  • O risco de a plataforma desaparecer ou mudar de política ainda existe
  • O Jekyll é lento com muito conteúdo, mas o Hugo é rápido
  • É fácil migrar entre Github Pages, CloudFlare Pages, Netlify e Vercel
  • O Kirby CMS parece ser a melhor opção
  • Um SSG pode sofrer deterioração de software se ficar abandonado por alguns anos
  • Usando Obsidian Publish, dá para remover Hugo, Github e Cloudflare