Introdução ao Gitblog: como manter a propriedade dos meus textos e administrar meu próprio blog

O que se acumula no blog não são apenas os textos. O processo de resolução de problemas, os momentos em que aprendi algo novo e as perspectivas sobre determinados temas também ficam registrados. Com o passar do tempo, esses registros se tornam um patrimônio que mostra o que me preocupava e como eu mudei.

Então, onde esse patrimônio deve ficar? Mesmo que o serviço em que eu escrevia mude ou desapareça, eu deveria poder continuar a armazená-lo e mantê-lo, não é mesmo?

O Gitblog é um serviço que permite armazenar posts públicos e o código do blog no meu repositório do GitHub, além de escrever posts pela web ou por meio de um agente de IA para publicá-los no meu blog. Com base na propriedade e gestão direta dos textos, adicionamos funcionalidades que facilitam a redação e a interação com os leitores.

A criação do Gitblog partiu de cinco premissas.

1. Os textos que escrevo devem ser de minha propriedade e eu devo poder gerenciá-los

Quanto mais tempo escrevo, mais importante se torna a certeza de que poderei sempre acessar esses textos. Acreditamos que o autor deve poder armazenar, editar e, se necessário, transferir seus registros para outro local.

Os posts públicos do Gitblog são armazenados como arquivos Markdown no seu repositório do GitHub. É possível gerenciar também os arquivos do blog, incluindo imagens, e o código-fonte. Ao baixar o repositório para o seu computador, você pode ler, editar e fazer backup dos posts localmente, além de verificar o conteúdo anterior por meio do histórico de alterações do Git.

Mesmo que o serviço Gitblog seja descontinuado, o repositório da minha conta, as postagens armazenadas localmente e o código do blog permanecerão. Se mantiver a hospedagem e o domínio, é possível continuar disponibilizando o blog estático publicado e, se necessário, transferir os arquivos para outra hospedagem. No entanto, os recursos de integração oferecidos pelo Gitblog, como navegação e assinaturas, dependem da operação do serviço.

É por isso que escolhemos o GitHub como base. Muitas pessoas já o utilizam, e ele oferece a infraestrutura necessária para iniciar um blog por meio de repositórios públicos e do GitHub Pages. Mesmo na versão gratuita do GitHub, é possível usar a hospedagem do Pages para repositórios públicos. O escopo e os limites de uso seguem a política do GitHub.

Não importa onde você escreva, é possível manter o original das postagens públicas sob seu controle. Esse é o primeiro princípio do Gitblog.

2. Deve ser um blog que permita o uso de IA

Escrever com a ajuda da IA está se tornando cada vez mais natural. Criar rascunhos a partir de anotações, organizar conteúdos complexos, refinar frases e traduzir para outros idiomas. Assim como um agente de programação lê e modifica os arquivos de um projeto, acredito que um agente que auxilia na redação também deva poder lidar diretamente com os arquivos do blog.

O repositório do Gitblog contém diretrizes e comandos de redação, tradução e verificação para referência dos agentes de IA. Ao designar o repositório do meu blog como alvo de trabalho para um agente capaz de ler e modificar arquivos locais e executar comandos, é possível redigir rascunhos e preparar a publicação nesse ambiente. Se houver as autenticações e permissões necessárias, é possível prosseguir até a distribuição.

Por exemplo, você pode fazer a seguinte solicitação:

Leia o arquivo AGENTS.md deste repositório do blog e siga as diretrizes de redação. Escreva o texto com base nas anotações que deixei e salve-o como rascunho para que eu possa revisá-lo.

Após concluir a revisão, você pode solicitar a tradução, a verificação e a distribuição. As tarefas possíveis variam de acordo com o escopo de acesso aos arquivos e as permissões de execução de comandos do agente utilizado. O fluxo específico está descrito no Guia de redação e tradução de blogs.

O Gitblog não obriga o uso de um modelo específico de IA para a redação. Você pode escrever diretamente na web, usar um editor com o qual esteja familiarizado ou trabalhar em conjunto com a IA. O objetivo é permitir que o autor escolha a ferramenta que melhor se adapte ao seu estilo.

3. Um bom texto deve poder ser descoberto independentemente do idioma e da ferramenta

Depois de publicar um texto, é preciso que alguém o descubra e o leia. Há quem busque respostas nos mecanismos de busca e quem, ao fazer perguntas a serviços de IA, encontre materiais relevantes. Há também leitores que leem em um idioma diferente do que você usa.

O Gitblog oferece uma estrutura para publicação multilíngue, pesquisa e acesso à IA, permitindo alcançar esses leitores.

Primeiro, é possível traduzir o texto original, escrito no idioma de sua preferência, para o idioma escolhido e publicá-lo. O sistema suporta a tradução automática por meio da integração com a API do DeepL ou a publicação de traduções revisadas, sejam elas feitas por pessoas ou por modelos de linguagem de grande escala (LLM). A tradução automática do DeepL requer uma chave de API específica. Caso você gerencie a tradução diretamente, o sistema oferece um procedimento para verificar se a tradução está atualizada sempre que o texto original for alterado.

Além disso, os modelos foram equipados com os seguintes elementos básicos para que os mecanismos de busca e as ferramentas de IA possam identificar o conteúdo e a fonte do texto.

• Informações da página para pesquisa: fornece título, descrição, URL do texto original, mapa do site e links para as páginas em cada idioma.
• Estrutura que explica o contexto do texto: fornece dados estruturados, como autor e data de publicação, e permite adicionar, conforme necessário, respostas-chave, fontes, perguntas e respostas.
• Caminhos de acesso direto ao texto: dependendo da configuração, fornece a versão em Markdown do artigo público e a lista de artigos llms.txt.

Trata-se de um projeto que leva em consideração a visibilidade em ambientes de IA de busca, resposta e geração — comumente chamados de SEO, AEO e GEO. O objetivo é apresentar o corpo do texto e seu contexto de forma fácil de ler. A classificação nos resultados de busca ou as citações nas respostas de IA são determinadas por cada serviço, não sendo garantidas apenas por traduções ou configurações técnicas. Guia de pesquisa e acesso à IA.

Também é possível encontrar artigos dentro do Gitblog. Os artigos dos blogs participantes do feed passam por um processo de coleta e são exibidos nas telas de exploração, como “Artigos mais recentes”, “Artigos populares” e “Tendências”. O leitor pode encontrar artigos de seu interesse e acessar o blog do autor para lê-los.

Nosso objetivo é ampliar a possibilidade de que os registros que deixamos cheguem às pessoas que precisam desse conteúdo.

4. A repercussão das postagens leva a conexões no GitHub

Ao ler um bom artigo, ficamos curiosos sobre o próximo texto do autor. Passamos a pesquisar que tipo de projeto essa pessoa está desenvolvendo e quais pensamentos ela está registrando.

No Gitblog, esse interesse se traduz em conexões no GitHub. A assinatura de um blog está vinculada a uma “estrela” (Star) no repositório do GitHub, e seguir um autor está vinculado ao botão “Seguir” (Follow) na conta do GitHub. O leitor pode reunir os posts de blogs ou autores de seu interesse, e o autor pode se conectar com os leitores também no GitHub por meio de seus registros.

Pode parecer algo trivial, mas acreditamos que essa conexão seja significativa. Isso porque os textos e pensamentos se somam à imagem que se revela por meio do código e dos projetos. Textos que explicam as decisões tomadas no projeto, o processo de resolução de problemas e o que foi aprendido tornam-se mais um canal para compreender o trabalho dessa pessoa.

O número de “Stars” ou de seguidores não determina o valor de um texto. No entanto, o fato de que um leitor que se identificou com o meu texto possa se tornar alguém que aguarda meu próximo post pode ser um motivo para continuar escrevendo regularmente.

5. Escrever continua sendo importante mesmo na era da IA

Escrevemos quando fazemos perguntas à IA. Explicamos o resultado desejado, organizamos as condições e, ao ler a resposta, fazemos novas perguntas. Mesmo quando a IA redige o prompt e o rascunho por nós, permanece o processo de decidir o que solicitar e quais resultados aceitar.

Escrever também é um processo de reflexão sobre os próprios pensamentos. Ao redigir frases para explicar algo, percebemos lacunas em aspectos que achávamos conhecer. Passamos a buscar fundamentos, corrigir argumentos contraditórios e conectar o contexto para que outras pessoas possam compreender.

Mesmo que a IA assuma cada vez mais tarefas, procuramos não esquecer nosso papel como seres humanos: decidir o que consideramos importante e quais ações tomar. Não perder de vista nossos próprios pensamentos e julgamentos, mesmo em textos escritos em conjunto com a IA — esse é o tipo de escrita que buscamos.

Espero que o Gitblog seja um espaço onde possamos continuar essa prática. Um espaço para explicar o que aprendemos com nossas próprias palavras, registrar experiências em um contexto significativo e, com o passar do tempo, reler esses textos para desenvolver nossas ideias.

Espero que a construção de bons textos se torne um processo de aprimoramento da própria inteligência.

Começando no Gitblog

É possível começar o Gitblog no Studio da web ou criar diretamente um repositório de blog no GitHub e operá-lo no seu computador local. Vamos ver primeiro como usar o Studio.

1. Cadastre-se com uma conta do GitHub

Acesse o Gitblog e cadastre-se ou faça login com sua conta do GitHub. Após o login, acesse o Studio, que é o espaço para criar e gerenciar seu blog.

2. Conecte o aplicativo do GitHub e crie um blog

Seguindo as instruções do Studio, instale o aplicativo Gitblog no GitHub e conceda acesso ao repositório para gerenciar o blog. Visualize os modelos disponíveis, escolha um e, em seguida, defina o título do blog e o nome do repositório.

Tela de seleção de modelos no Studio em inglês. Em 3 de novembro de 2026.

Os arquivos do blog serão criados no seu repositório do GitHub. Para hospedagem, você pode usar o GitHub Pages ou conectar sua conta do Cloudflare para usar o Cloudflare Pages. Depois de concluir as configurações de implantação do método escolhido, você estará pronto para publicar posts.

3. Escrever e publicar um post em Markdown

Na tela de redação do Studio, digite o título, a descrição e o corpo do texto em Markdown. Também é possível fazer o upload de uma imagem de capa para a miniatura do post e de imagens para o corpo do texto.

Enquanto escreve, salve como rascunho e, após revisar o conteúdo, salve como publicado. Após salvar, verifique o andamento da compilação e da distribuição; quando a distribuição estiver concluída, você poderá ler a postagem no seu blog. Se for necessária uma tradução, basta configurar os idiomas de tradução e as formas de uso do blog para operá-lo em conjunto.

Começando no GitHub e no seu computador

Se quiser trabalhar com um editor local ou um agente de IA, você pode escolher o modelo oficial do Gitblog de sua preferência no GitHub e começar diretamente.

1. Crie o repositório do seu blog usando um modelo. Na página do GitHub do modelo oficial desejado, use o modelo para criar um novo repositório público na sua conta. Será criado um repositório do blog para você gerenciar, independente do modelo original.
2. Clone o seu repositório no seu computador local. Execute o git clone usando o endereço do repositório criado e abra a pasta baixada no editor ou no agente de IA para trabalhar. Siga as instruções do modelo para instalar as ferramentas de desenvolvimento e dependências necessárias e conclua as configurações iniciais, como endereço do blog, idioma e hospedagem.
3. Escreva e verifique o texto localmente. Escreva um texto em Markdown no content/posts/ e adicione imagens. Você pode editar diretamente ou solicitar ao agente que leia o AGENTS.md e siga as instruções de redação. Após revisar o rascunho, altere o status para “publicado” e execute o procedimento de validação fornecido pelo modelo.
4. Envie as alterações para o GitHub e faça a distribuição. Ao fazer o commit do texto e das imagens e enviar (push) para o branch de distribuição, o fluxo de trabalho do GitHub Actions configurado irá compilar o blog e distribuí-lo para a hospedagem selecionada. Verifique os resultados da execução do Actions e se as alterações foram refletidas na página real do blog.

Na primeira vez, você deverá preparar o ambiente de distribuição seguindo o Guia de configuração inicial do modelo escolhido. A partir daí, você poderá continuar escrevendo seguindo o fluxo: escrever localmente → revisar e validar → fazer commit e push → confirmar a distribuição.

Mesmo um blog criado diretamente no GitHub pode ser gerenciado no Gitblog App, desde que você conceda acesso ao repositório e utilize o recurso de conexão com blogs existentes do Studio. Basta escolher o método mais adequado ao seu trabalho: escrever na web ou escrever localmente.

Comece onde seus textos ficam guardados

O Gitblog busca ser um blog que armazena seus textos na sua conta, permite que você os escreva com ferramentas com as quais está acostumado e alcança leitores em diferentes idiomas e canais. Na base disso está a crença de que, por meio da escrita, é possível compreender mais profundamente os próprios pensamentos.

Não é preciso escrever um texto perfeito desde o início. Experimente registrar um fato que você descobriu hoje, uma questão sobre a qual vem refletindo há muito tempo ou um problema que você mesmo resolveu. O processo de adicionar contexto a esse registro e refiná-lo levará ao próximo texto.

Acumule seus pensamentos em um blog que você mesmo possui e administra.

Começar meu blog no Gitblog