● goodtek

Git으로 Obsidian 노트를 동기화할 때 충돌을 줄이는 원칙

7 min read

Android에서 Obsidian으로 메모를 수정하고, Termux에서 Git으로 pull, commit, push를 해보면서 중요한 걸 하나 배웠습니다.

Git은 파일을 잘 합쳐주지만, 같은 파일의 같은 위치를 여러 기기에서 동시에 수정하면 자동으로 처리하기 어렵다는 점입니다.

예를 들어 PC에서 content/backlog/tasks.md를 수정하고 GitHub에 push했습니다.
그런데 Android에서도 같은 tasks.md를 수정한 상태에서 git pull --rebase를 실행하면 충돌이 날 수 있습니다.

GitHub:  A → B
Android: A → C

Git은 GitHub의 최신 변경사항 B 위에 Android의 변경사항 C를 다시 얹으려고 합니다.

A → B → C

하지만 B와 C가 같은 파일, 같은 줄 근처를 수정했다면 Git은 어느 쪽 내용을 살려야 할지 판단하지 못합니다.

그래서 이런 충돌이 발생합니다.

CONFLICT (content): Merge conflict in content/backlog/tasks.md

이건 Git이 망가진 것이 아니라, 오히려 내용을 함부로 덮어쓰지 않기 위해 멈춘 것입니다.

동시에 수정하면 왜 어려운가

서로 다른 파일을 수정하면 Git이 대부분 자동으로 합칠 수 있습니다.

PC      → content/blog/idea.md 수정
Android → content/backlog/tasks.md 수정

이 경우는 충돌 가능성이 낮습니다.

하지만 같은 파일을 양쪽에서 수정하면 충돌 가능성이 높아집니다.

PC      → content/backlog/tasks.md 수정
Android → content/backlog/tasks.md 수정

특히 같은 줄 근처를 수정하면 Git은 사람이 판단해야 한다고 보고 멈춥니다.

결국 문제는 “Git을 못 써서”가 아니라, 하나의 파일을 여러 기기에서 동시에 편집하는 구조 자체가 충돌에 취약하다는 점입니다.

앞으로의 운영 원칙

Goodtek notes는 Android, PC, GitHub가 함께 쓰이는 구조입니다.

그래서 앞으로는 아래 원칙으로 운영하는 것이 좋겠습니다.

수정 전에는 먼저 받기
수정 후에는 바로 올리기

Android에서 작업할 때는 먼저 최신 상태를 받습니다.

pull-notes

그 다음 Obsidian에서 메모를 수정합니다.

수정이 끝나면 바로 올립니다.

sync-notes

PC에서 작업할 때도 마찬가지입니다.

git pull --rebase origin main
 
# 메모 수정
 
git add content
git commit -m "Update notes"
git push

핵심 흐름은 단순합니다.

받고 → 쓰고 → 올리기

파일을 쪼개면 충돌이 줄어든다

tasks.md 하나에 모든 백로그를 계속 적으면 충돌이 자주 날 수 있습니다.

특히 Android와 PC에서 자주 열어보는 파일이라면 더 그렇습니다.

그래서 하나의 큰 파일에 모든 걸 넣기보다, 역할별로 나누는 편이 좋습니다.

예를 들면 이렇게 나눌 수 있습니다.

content/backlog/
├── inbox.md
├── tasks.md
├── ideas.md
└── content-ideas.md

더 충돌을 줄이려면 날짜별 파일도 괜찮습니다.

content/backlog/daily/
├── 2026-06-03.md
├── 2026-06-04.md
└── 2026-06-05.md

또는 월별로 나눌 수도 있습니다.

content/backlog/
├── tasks-2026-06.md
├── ideas-2026-06.md
└── content-ideas-2026-06.md

이렇게 하면 PC와 Android가 같은 파일을 동시에 수정할 확률이 줄어듭니다.

Goodtek notes 추천 구조

Goodtek notes에서는 Android와 PC의 역할을 나누는 방식이 좋아 보입니다.

Android
→ 빠른 메모, 순간적으로 떠오른 생각 기록
 
PC
→ 정리, 편집, 블로그 글로 확장, 구조화

그래서 Android에서는 주로 inbox.md를 사용합니다.

content/backlog/inbox.md

생각난 것은 일단 여기에 빠르게 적습니다.

- 나중에 Android Git 동기화 글 블로그로 정리하기
- notes.goodtek.xyz 백로그 구조 정리하기
- sync-notes 충돌 방지 로직 개선하기

그리고 PC에서 시간이 날 때 정리합니다.

inbox.md
→ tasks.md
→ content-ideas.md
→ build-log
→ blog.goodtek.xyz 글

이렇게 하면 Android에서는 빠르게 기록하고, PC에서는 천천히 정리할 수 있습니다.

정리

이번에 배운 것은 단순한 Git 명령어가 아닙니다.

Obsidian 노트를 여러 기기에서 운영하려면 Git 충돌을 없애는 것보다, 충돌이 덜 나게 쓰는 구조를 만드는 것이 더 중요하다는 점입니다.

앞으로 Goodtek notes는 이렇게 운영합니다.

Android에서 쓰기 전 pull-notes
Android에서 쓴 후 sync-notes
 
PC에서 쓰기 전 git pull --rebase
PC에서 쓴 후 git push
 
Android는 inbox 중심
PC는 정리와 편집 중심
 
하나의 큰 파일보다 작은 파일 여러 개
동시에 같은 파일 수정하지 않기

결국 핵심은 이것입니다.

Git을 잘 쓰는 방법은 충돌을 잘 해결하는 것만이 아니다.
충돌이 덜 나는 기록 구조를 만드는 것이다.

Goodtek notes도 이런 작은 운영 원칙을 하나씩 쌓아가면서 더 오래 유지할 수 있는 기록 시스템으로 만들어가야겠습니다.

Graph View