A grande dificuldade de muitos desenvolvedores que estão iniciando é, aonde compartilhar meu conhecimento? Eu crio um blog? Eu uso o Medium? Eu uso o Dev.to? O que fazer? Bom, vamos para a solução mais bonita que é ter seu próprio blog. Claro que eu não vou diminuir quem cria conteúdo em outros lugares, mas centralizar seu conhecimento é a melhor opção.

Vamos lá, o que vamos precisar?

Github Pages

O Github Pages é um serviço do Github que nos possibilita hospedar sites estáticos, normalmente utilizado para hospedar documentação dos projetos nos repositórios git, ele nos possibilita renderizar tanto páginas HTML quanto em Markdown.

Site oficial: https://pages.github.com/

Obsidian

O Obsidian é um aplicativo de anotação, o segredo é que ele gera os arquivo em Markdown uma peça chave para novo propósito. Claro que podemos utilizar, os próprios arquivos .md/.mdx ou usar o Notion, mas isso é outro tutorial.1

Site oficial: https://obsidian.md/

Quartz

O Quartz é um gerador de site estáticos, o pulo do gato é que ele será encarregado de pegar nosso arquivos de anotações gerado em Markdown pelo nosso Obsidian e converterá em HTML, só que ele não faz apenas isso. Ele é customizável e adiciona algumas funcionalidade ao nosso blog como grade de laytout, menus, barra de busca, tema escuro e claro, além de outras customizações que você pode estar fazendo. Se preferir de uma olhada na documentação para mais detalhes e não se esqueça de dar uma estrelinha no repositório do projeto.

Documentação: https://quartz.jzhao.xyz/ - Github: https://github.com/jackyzha0/quartz

Fluxo de Postagem

O fluxo funcionará da seguinte forma: Obsidian > Commit Push > Deploy Github Actions

1. Criar/editar seu arquivos no obsidian
2. Fazer o commit e fazer o push para seu repositório online
3. Rodar pipeline no Github Actions para fazer o deploy das alterações