메인 콘텐츠로 건너뛰기
프로젝트를 GitHub 저장소에 연결하세요. 변경 사항은 양방향으로 이동하며, Sync를 클릭할 때만 이동합니다. 자동으로 동기화되는 것은 없습니다.
Account settings나 편집기에 GitHub 옵션이 보이지 않으면 관리자에게 GitHub 동기화를 켜 달라고 요청하세요.
이 작업은 한 번만 합니다.
1

계정 설정 열기

Account를 클릭한 다음 Account settings를 클릭합니다. GitHub까지 스크롤하고 Link를 클릭합니다.
Link 버튼이 있는 계정 설정의 GitHub 섹션

계정 설정의 GitHub

2

GitHub에서 승인

GitHub가 열립니다. 요청을 받으면 로그인한 다음 애플리케이션을 승인합니다.
3

연결 확인

계정 설정으로 돌아오며, 이제 버튼에 Unlink가 표시됩니다.
Unlink 버튼이 있는 계정 설정의 GitHub 섹션

GitHub 계정이 연결됨

계정이 아직 연결되지 않았다면 Import from GitHub와 편집기의 GitHub 카드가 먼저 연결하라고 요청합니다. Link to your GitHub account를 클릭하세요. 이 경우에도 계정 설정으로 이동하며, 편집기에서 시작했다면 새 탭에서 열립니다. 그런 다음 돌아가서 다시 시작하세요.
Link to your GitHub account 버튼이 있는 Import from GitHub 대화 상자

계정이 연결되지 않았을 때의 안내

저장소 가져오기

GitHub 저장소에서 새 프로젝트를 만들며, 이 프로젝트는 이미 해당 저장소에 연결되어 있습니다.
1

가져오기 대화 상자 열기

프로젝트 페이지에서 New project를 클릭한 다음 Import from GitHub를 클릭합니다.
Import from GitHub가 있는 New project 메뉴

New project 메뉴

New project는 프로젝트가 하나 이상 있을 때 나타납니다. 시작 페이지의 Create a new project 메뉴에는 가져오기가 없으므로, 먼저 빈 프로젝트를 만드세요.
2

저장소 선택

저장소 옆의 Import to Overleaf를 클릭합니다. 목록에는 내 저장소와 내가 속한 조직의 저장소가 포함됩니다.
저장소 네 개가 나열된 Import from GitHub 대화 상자

내 GitHub 저장소

조직의 저장소가 보이지 않으면 Can’t see what you’re looking for?를 클릭해 해당 조직에서 애플리케이션을 승인하는 방법에 대한 GitHub 도움말을 확인하세요.
3

프로젝트 확인

새 프로젝트가 저장소의 파일과 함께 열립니다.
가져온 프로젝트의 파일과 컴파일된 PDF를 보여 주는 편집기

가져온 프로젝트

프로젝트를 새 저장소로 내보내기

내가 소유한 프로젝트에서 저장소를 만들고 둘을 연결합니다. 프로젝트는 이 방법이나 가져오기로만 연결할 수 있으며, 이미 존재하는 저장소에는 연결할 수 없습니다.
1

편집기에서 GitHub 열기

프로젝트를 엽니다. 왼쪽 막대에서 Integrations를 클릭한 다음 GitHub를 클릭합니다.
GitHub 카드가 있는 Integrations 패널

Integrations 패널

2

저장소 정보 입력

Owner를 선택합니다. 본인 또는 내가 속한 조직 중 하나를 선택할 수 있습니다. Repository Name의 초기값은 프로젝트 이름입니다. 설명은 선택 사항이며, Private가 기본으로 선택되어 있습니다. Create a GitHub repository를 클릭합니다.
입력이 완료된 Export Project to GitHub 양식

Export Project to GitHub

3

연결 확인

이제 대화 상자에 This project is linked to와 저장소 이름이 표시됩니다.
내보내기 후의 Sync with GitHub 대화 상자

프로젝트가 연결됨

동기화하기

1

동기화 대화 상자 열기

연결된 프로젝트를 엽니다. 왼쪽 막대에서 Integrations를 클릭한 다음 GitHub를 클릭합니다.Recent commits in GitHub에 프로젝트로 들어올 내용이 나열됩니다.
새 커밋 하나가 나열된 Sync with GitHub 대화 상자

GitHub에서 대기 중인 새 커밋

2

변경 사항 설명

프로젝트에서 무언가를 변경했다면 커밋 메시지 입력란이 나타납니다. 입력은 선택 사항이며, 비워 두면 커밋 이름은 Updates from Overleaf가 됩니다.
커밋 메시지가 입력된 Sync with GitHub 대화 상자

변경 사항의 커밋 메시지

3

Sync 클릭

Sync를 클릭합니다. GitHub의 새 커밋이 프로젝트로 들어오고, 내 변경 사항은 저장소의 기본 브랜치로 갑니다. 양쪽에서 서로 다른 부분을 변경했다면 자동으로 병합됩니다.
4

결과 확인

대화 상자에 No new commits in GitHub since last merge.가 표시되고 커밋 메시지 입력란이 사라집니다. 편집기의 파일과 GitHub의 커밋이 최신 상태입니다.
동기화 후 새 커밋이 없는 Sync with GitHub 대화 상자

모두 동기화됨

양쪽에서 같은 줄이 변경된 경우

대화 상자에 변경 사항을 병합할 수 없다는 메시지와 함께, 내 변경 사항을 담은 새 브랜치 overleaf-YYYY-MM-DD-HHMMSS의 이름이 표시됩니다.
병합 충돌 경고가 있는 Sync with GitHub 대화 상자

충돌

  1. GitHub에서 또는 Git으로 해당 브랜치를 기본 브랜치에 병합합니다. 그동안 대화 상자를 닫아도 됩니다. 다시 열면 같은 메시지가 표시됩니다.
  2. I have manually merged. Continue를 클릭합니다. 병합된 결과가 프로젝트로 들어옵니다.
  3. 브랜치는 GitHub에 남습니다. 더 이상 필요하지 않으면 삭제하세요.
프로젝트를 더 이상 동기화하지 않으려면 이 작업을 합니다. 프로젝트 소유자만 할 수 있습니다.
1

Unlink 클릭

동기화 대화 상자에서 Unlink를 클릭합니다.
2

확인

Confirm을 클릭합니다. 구독에 관한 안내가 있어도 프로젝트를 다시 연결할 수 있습니다.
연결 해제 확인을 요청하는 Sync with GitHub 대화 상자

연결 해제 확인

3

결과 확인

이제 대화 상자에 Export Project to GitHub가 표시됩니다. 프로젝트와 저장소는 모두 내용을 유지합니다. 다시 동기화하려면 프로젝트를 새 저장소로 내보내거나, 저장소를 새 프로젝트로 가져오세요.
Account settings의 GitHub에서 Unlink를 클릭한 다음, 대화 상자에서 다시 Unlink를 클릭합니다.
Unlink GitHub Account 대화 상자

계정 연결 해제

프로젝트는 각자의 저장소에 연결된 상태로 남습니다. 계정을 다시 연결할 때까지 동기화할 수 없습니다.
공유 프로젝트에서 누가 무엇을 할 수 있는지는 연결 및 동기화할 수 있는 사람을 참조하세요. 동기화하는 공동 작업자는 각자 자신의 GitHub 계정을 연결합니다.
마지막 수정일 2026년 11월 20일