Saltar para o conteúdo principal
Conecte um projeto a um repositório do GitHub. As alterações vão nos dois sentidos, e só quando você clica em Sync: nada é sincronizado sozinho.
Se você não vir nenhuma opção do GitHub em Account settings ou no editor, peça ao seu administrador para ativar a sincronização com GitHub.
Você faz isso uma vez.
1

Abra as configurações da conta

Clique em Account e depois em Account settings. Role até GitHub e clique em Link.
A seção GitHub das configurações da conta com um botão Link

GitHub nas configurações da conta

2

Autorize no GitHub

O GitHub abre. Faça login se for solicitado e depois autorize o aplicativo.
3

Verifique o vínculo

Você volta às configurações da conta, e o botão agora diz Unlink.
A seção GitHub das configurações da conta com um botão Unlink

Sua conta do GitHub está vinculada

Se sua conta ainda não estiver vinculada, Import from GitHub e o cartão GitHub no editor pedem que você a vincule primeiro. Clique em Link to your GitHub account. Você também chega às configurações da conta, em uma nova aba se tiver começado no editor. Depois volte e comece de novo.
A caixa de diálogo Import from GitHub com um botão Link to your GitHub account

O aviso quando sua conta não está vinculada

Importar um repositório

Isso cria um novo projeto a partir de um repositório do GitHub, já vinculado a ele.
1

Abra a caixa de diálogo de importação

Na página de projetos, clique em New project e depois em Import from GitHub.
O menu New project com Import from GitHub

O menu New project

New project aparece quando você tem um projeto. O menu Create a new project da página de boas-vindas não tem importação, então crie primeiro um projeto em branco.
2

Escolha o repositório

Clique em Import to Overleaf ao lado do repositório. A lista inclui seus repositórios e os das suas organizações.
A caixa de diálogo Import from GitHub listando quatro repositórios

Seus repositórios do GitHub

Se faltar o repositório de uma organização, clique em Can’t see what you’re looking for? para ver a ajuda do GitHub sobre como aprovar o aplicativo para essa organização.
3

Verifique o projeto

O novo projeto abre com os arquivos do repositório.
O editor mostrando o projeto importado com seus arquivos e o PDF compilado

O projeto importado

Exportar um projeto para um novo repositório

Isso cria um repositório a partir de um projeto do qual você é dono e os vincula. Um projeto só pode ser vinculado dessa forma ou por importação: não é possível vinculá-lo a um repositório que já existe.
1

Abra o GitHub no editor

Abra o projeto. Na barra à esquerda, clique em Integrations e depois em GitHub.
O painel Integrations com o cartão GitHub

O painel Integrations

2

Preencha o repositório

Escolha o Owner, que pode ser você ou uma das suas organizações. Repository Name começa com o nome do projeto. A descrição é opcional, e Private vem selecionado por padrão. Clique em Create a GitHub repository.
O formulário Export Project to GitHub preenchido

Export Project to GitHub

3

Verifique o vínculo

A caixa de diálogo agora diz This project is linked to e nomeia o repositório.
A caixa de diálogo Sync with GitHub após a exportação

O projeto está vinculado

Sincronizar

1

Abra a caixa de diálogo de sincronização

Abra um projeto vinculado. Na barra à esquerda, clique em Integrations e depois em GitHub.Recent commits in GitHub lista o que vai entrar no projeto.
A caixa de diálogo Sync with GitHub listando um novo commit

Um novo commit esperando no GitHub

2

Descreva suas alterações

Se você alterou algo no projeto, aparece um campo para a mensagem de commit. Ele é opcional: se você deixá-lo vazio, o commit se chama Updates from Overleaf.
A caixa de diálogo Sync with GitHub com uma mensagem de commit preenchida

A mensagem de commit das suas alterações

3

Clique em Sync

Clique em Sync. Os novos commits do GitHub entram no projeto, e suas alterações vão para o branch padrão do repositório. Se os dois lados alteraram coisas diferentes, elas são mescladas para você.
4

Verifique o resultado

A caixa de diálogo mostra No new commits in GitHub since last merge. e o campo da mensagem de commit desaparece. Os arquivos no editor e os commits no GitHub estão atualizados.
A caixa de diálogo Sync with GitHub após a sincronização, sem novos commits

Tudo está sincronizado

Se as mesmas linhas mudaram dos dois lados

A caixa de diálogo informa que as alterações não puderam ser mescladas e nomeia um novo branch, overleaf-YYYY-MM-DD-HHMMSS, que contém suas alterações.
A caixa de diálogo Sync with GitHub com um aviso de conflito de mesclagem

Um conflito

  1. Mescle esse branch no branch padrão no GitHub ou com Git. Você pode fechar a caixa de diálogo nesse meio-tempo: ela mostra a mesma mensagem quando você a abre de novo.
  2. Clique em I have manually merged. Continue. O resultado mesclado entra no projeto.
  3. O branch fica no GitHub. Exclua-o quando não precisar mais dele.
Faça isso quando não quiser mais que o projeto seja sincronizado. Só o dono do projeto pode fazer isso.
1

Clique em Unlink

Na caixa de diálogo de sincronização, clique em Unlink.
2

Confirme

Clique em Confirm. A observação sobre uma assinatura não impede que você vincule o projeto de novo.
A caixa de diálogo Sync with GitHub pedindo para confirmar a desvinculação

Confirme a desvinculação

3

Verifique o resultado

A caixa de diálogo agora mostra Export Project to GitHub. O projeto e o repositório mantêm seu conteúdo. Para sincronizar de novo, exporte o projeto para um novo repositório ou importe o repositório para um novo projeto.
Em Account settings, em GitHub, clique em Unlink e depois em Unlink novamente na caixa de diálogo.
A caixa de diálogo Unlink GitHub Account

Desvincule sua conta

Seus projetos continuam vinculados aos repositórios. Você não pode sincronizá-los até vincular sua conta de novo.
Para saber quem pode fazer o quê em um projeto compartilhado, consulte Quem pode vincular e sincronizar. Cada colaborador que sincroniza vincula a própria conta do GitHub.
Última modificação em 20 de novembro de 2026