Publicar artigos no GitHub

Conecte o GitHub uma vez e você poderá publicar qualquer artigo do Clevera em um repositório como um arquivo Markdown, pronto para um site de documentação, uma pasta docs/ estilo wiki ou uma coleção de README. Este artigo aborda a conexão, a escolha do repositório e da pasta, a aparência do arquivo e como as atualizações funcionam.

Antes de começar#

• Plano: a publicação no GitHub faz parte dos planos Pro e Custom. Nos planos Free e Starter, a aba Publicar exibe "A publicação em suas ferramentas está incluída no plano Pro". Veja Escolher um plano.
• Função no Clevera: apenas o proprietário do workspace ou um Administrador pode conectar ou desconectar o GitHub. Uma vez conectado, qualquer pessoa que possa editar um artigo pode publicá-lo.
• Acesso no GitHub: a pessoa que faz a conexão precisa de acesso de escrita aos repositórios nos quais você deseja publicar e o direito de instalar um GitHub App nessa conta pessoal ou organização (ou um proprietário da organização para aprová-lo).
• Um artigo: você publica o artigo que pertence a um vídeo ou gravação. Gere-o primeiro; veja Transformar uma gravação em um artigo.

A publicação não utiliza créditos.

Conectar o GitHub#

1. Abrir Integrações#

   Na barra lateral, abra o menu do workspace e escolha Integrações. Encontre o GitHub em Integrações disponíveis (ou na aba Desenvolvimento) e clique em Conectar. O botão aparece quando você aponta para o cartão.

   

2. Autorizar o Clevera no GitHub#

   O GitHub solicita que você autorize o aplicativo Clevera AI. Ele solicita acesso de leitura às suas associações de organização, para que o Clevera possa listar as contas às quais você pertence. Clique em Autorizar.

3. Instalar o aplicativo em seus repositórios#

   O GitHub abre então a página de instalação do aplicativo Clevera AI. Escolha sua conta pessoal ou uma organização e, em seguida, escolha Todos os repositórios ou Apenas repositórios selecionados. O aplicativo solicita:

   Permissão do GitHub	Por que
   Conteúdo: leitura e escrita	Para criar e atualizar o arquivo Markdown e suas imagens
   Metadados: somente leitura	Exigido pelo GitHub para todo aplicativo; permite que o Clevera liste repositórios

   Clique em Instalar. Repita para cada organização na qual você deseja publicar.

4. Verificar a conexão#

   De volta a Integrações, o GitHub é movido para a lista Conectado com o nome da sua conta ou organização do GitHub e um selo Conectado. Antes de publicar qualquer coisa, ele exibe "Nada publicado ainda".

   

Adicionar ou remover repositórios posteriormente#

O Clevera só vê os repositórios nos quais o aplicativo está instalado. Para alterar isso, abra Integrações, clique em GitHub e, em Acesso, clique em Acesso ao repositório. No GitHub, abra a conta, clique em Configurar e altere a lista de repositórios. Novos repositórios aparecem na próxima vez que você abrir a aba Publicar.

Publicar um artigo#

1. Abrir a aba Publicar#

   No editor, clique em Compartilhar e abra a aba Publicar. Em Publicar o artigo, clique no bloco GitHub em Pronto para publicar.

   O artigo é publicado no idioma que você tem aberto no editor. Alterne o idioma na barra superior primeiro para publicar uma tradução.

2. Escolher a conta, o repositório e a pasta#

   Em Onde ele vai, escolha:

   Campo	O que escolher	Notas
   Conta	Sua conta pessoal ou uma organização	Exibido apenas quando seus repositórios pertencem a mais de uma conta
   Repositório	O repositório para o arquivo	Mais recentemente atualizado primeiro. O primeiro é selecionado para você
   Pasta	Um caminho como docs ou articles/guides	"O arquivo Markdown é criado aqui. Deixe vazio para a raiz do repositório." Começa como docs. Pastas que ainda não existem são criadas

   O Clevera lembra o que você escolheu para a próxima vez.

   

3. Publicar#

   Clique em Publicar no GitHub. Você verá "Procurando por uma cópia existente no GitHub", depois Escrevendo a página. Quando terminar, você verá "Publicado no GitHub." Clique em Abrir no GitHub para ver o arquivo.

   Você pode fechar a janela Compartilhar enquanto ele é executado; uma notificação avisa quando terminar.

Onde o arquivo vai#

• Branch: a branch padrão do repositório (geralmente main). O Clevera faz o commit diretamente nela; ele não abre um pull request e você não pode escolher outra branch.
• Nome do arquivo: o título em letras minúsculas, com espaços transformados em hifens, terminando em .md. "Create your first invoice" torna-se create-your-first-invoice.md. Títulos em outros scripts ou com acentos são escritos primeiro em letras latinas ("Créer une facture" torna-se creer-une-facture.md). Um título sem nada para escrever, como um feito apenas de emojis, recebe um código fixo curto (article- mais 8 caracteres). Nomes são cortados em 80 caracteres.
• Imagens: as capturas de tela do artigo vão para assets/<file name>/ dentro da mesma pasta, no mesmo commit.
• Mensagem de commit: Add article: <title>, ou Update article: <title> quando você atualiza um arquivo existente.
• Autor do commit: a conta do GitHub que conectou a integração.

Como o arquivo se parece#

O Clevera escreve Markdown estilo GitHub com um bloco de front matter curto no topo:

---
title: "Create your first invoice"
created_at: "2026-10-12T09:30:00+00:00"
updated_at: "2026-10-12T10:05:00+00:00"
source: "Clevera"
---

O vídeo de onde o artigo veio não é adicionado ao arquivo. Um vídeo do Clevera colocado dentro do artigo torna-se um link para seu player, apenas quando o link de compartilhamento desse vídeo estiver ativado. Veja Mostrar um vídeo em um artigo.

Imagens#

As capturas de tela são commitadas em seu repositório ao lado do arquivo, e o Markdown vincula-se a elas por caminho relativo (assets/<file name>/…). Elas continuam funcionando sem o Clevera, e em um repositório privado elas permanecem tão privadas quanto o restante dele.

Um arquivo de vídeo que você carregou no artigo não é commitado. Ele permanece um link para o Clevera que expira após um tempo; publique novamente para renová-lo.

Usar com um site de documentação#

A maioria dos geradores de sites estáticos que compilam a partir de um repositório (como Docusaurus, MkDocs, Jekyll ou Hugo) lê title do front matter e ignora campos que não conhece. Uma configuração comum:

1. Aponte a Pasta para a pasta que seu site de documentação lê, por exemplo docs ou content/guides.
2. Publique cada artigo lá; a compilação normal do seu site captura o novo commit.
3. Verifique se o seu gerador renderiza alertas do GitHub, matemática e <details>; alguns mostram alertas como citações simples.

Atualizar um artigo que você já publicou#

A publicação funciona apenas em uma direção. As edições que você faz no Clevera permanecem no Clevera até que você publique novamente, e as alterações feitas no arquivo no GitHub nunca voltam para o Clevera.

Ao publicar no mesmo repositório e pasta, o Clevera encontra o arquivo com o mesmo nome e exibe "Este artigo já está no GitHub." Clique em Visualizá-lo para abrir o arquivo existente, então escolha:

Se o título for alterado no Clevera, o nome do arquivo também muda, portanto, a publicação cria um novo arquivo ao lado do antigo. Exclua ou renomeie o arquivo antigo no GitHub por conta própria.

Nada no Clevera exclui arquivos do seu repositório.

Desconectar GitHub#

1. Abra Integrações, clique no menu ⋯ na linha do GitHub e escolha Desconectar (ou clique em GitHub e depois em Desconectar).
2. Confirme. "Você não pode mais publicar nele a partir do editor. O conteúdo que você já publicou permanece no GitHub."

Desconectar exclui o token de acesso do Clevera. Para remover o acesso do Clevera no GitHub também, desinstale o aplicativo Clevera AI (Configurações do GitHub → Applications → Installed GitHub Apps → Configure → Uninstall) e revogue a autorização em Authorized GitHub Apps.

Solução de problemas#

Relacionado#