옵시디언과 깃허브(GitHub) 연동으로 무료 동기화 및 백업 구축하기

옵시디언(Obsidian)은 모든 데이터가 내 컴퓨터 하드디스크에 텍스트 파일(.md)로 저장되는 '로컬 기반' 프로그램입니다. 서버가 해킹당하거나 서비스가 종료되어도 내 메모는 안전하다는 엄청난 장점이 있죠. 하지만 치명적인 단점도 존재합니다. 데스크톱에서 작성한 메모를 퇴근길에 스마트폰이나 노트북에서 이어서 보기가 까다롭다는 점입니다.

공식 서비스인 '옵시디언 싱크(Obsidian Sync)'를 결제하면 매우 편하지만, 매월 구독료가 부담스러울 수 있습니다. 그래서 초기 사용자들은 구글 드라이브나 아이클라우드에 폴더를 넣고 동기화를 시도합니다. 제가 바로 그렇게 하다가 큰코다친 케이스입니다. 오늘은 클라우드 동기화의 한계와, 개발자들의 무기인 '깃허브(GitHub)'를 활용해 가장 안전하고 무료로 옵시디언을 동기화하는 방법을 제 경험을 바탕으로 안내해 드립니다.

1. 구글 드라이브 대신 깃허브(GitHub)를 써야 하는 이유

처음엔 저도 구글 드라이브 데스크톱 앱을 통해 옵시디언 볼트(Vault) 폴더를 동기화했습니다. 하지만 며칠 지나지 않아 심각한 문제가 발생했습니다.

클라우드 드라이브는 실시간 동기화를 시도하기 때문에, 옵시디언의 설정 파일이나 플러그인 캐시 파일이 충돌을 일으킵니다. 결국 파일명 뒤에 '(충돌된 사본)'이라는 이름표가 붙은 쓰레기 파일들이 수백 개씩 증식하면서 앱이 멈춰버렸습니다.

반면 깃허브(GitHub)는 '버전 관리'에 특화된 시스템입니다.

  • 충돌 방지: 내가 '저장(Commit)'하고 '업로드(Push)'하는 시점에만 동기화가 일어나므로 파일이 꼬일 확률이 현저히 적습니다.

  • 완벽한 백업 및 복구: 실수로 중요한 노트를 지우거나 덮어써도, 깃허브에는 과거의 모든 수정 기록(버전)이 남아있어 클릭 몇 번이면 언제든 과거 상태로 되돌릴 수 있습니다. 노트 관리에 있어 이보다 든든한 보험은 없습니다.

2. 깃허브 연동 전 필수 준비물 3가지

개발자가 아니더라도 겁먹을 필요 없습니다. 아래의 세 가지만 순서대로 준비해 주세요.

  1. 깃허브(GitHub) 계정: github.com 에 접속해 무료 회원가입을 진행합니다.

  2. 깃허브 데스크톱(GitHub Desktop) 설치: 복잡한 검은색 터미널 화면 대신, 마우스 클릭만으로 깃허브를 조작하게 해주는 공식 무료 프로그램입니다.

  3. 옵시디언 깃(Obsidian Git) 플러그인: 옵시디언 설정 > 커뮤니티 플러그인에서 검색하여 설치해 둡니다.

3. 초보자를 위한 무료 동기화 세팅 3단계

준비물이 갖춰졌다면, 이제 내 옵시디언 보관함을 깃허브 서버와 연결할 차례입니다.

1단계: 프라이빗 레포지토리(Private Repository) 생성 깃허브 홈페이지에 로그인 후 'New repository' 버튼을 누릅니다. 저장소 이름을 정하고(예: My-Obsidian-Vault), 반드시 'Private(비공개)'을 선택해야 합니다. 'Public'으로 하면 전 세계 누구나 내 일기장과 노트를 볼 수 있으니 절대 주의하세요.

2단계: 내 컴퓨터로 가져오기 (Clone) 설치해 둔 '깃허브 데스크톱' 앱을 열고 방금 만든 저장소를 내 컴퓨터의 원하는 위치에 'Clone(복제)' 합니다. 그러면 빈 폴더가 하나 생깁니다. 이제 기존에 사용하던 옵시디언 보관함 안의 모든 파일과 폴더를 이 빈 폴더 안으로 통째로 잘라내기 하여 옮겨 넣습니다.

3단계: 옵시디언에서 보관함 다시 열기 옵시디언을 실행하고 'Open folder as vault(폴더를 보관함으로 열기)'를 선택해, 방금 파일들을 옮겨 넣은 깃허브 폴더를 지정해 줍니다.

이제 깃허브 데스크톱 앱을 보면 수많은 파일이 새로 추가되었다고 뜰 것입니다. 하단에 'Initial commit(첫 저장)'이라고 적고 'Commit' 버튼을 누른 뒤, 상단의 'Push origin(서버로 올리기)' 버튼을 누르면 1차 백업이 완벽하게 끝납니다.

4. 실전 활용: 플러그인으로 동기화 '자동화'하기

매번 글을 쓸 때마다 깃허브 데스크톱 앱을 켜서 버튼을 누르는 것은 너무 귀찮은 일입니다. 그래서 아까 설치해 둔 'Obsidian Git' 플러그인을 활용해 이 과정을 백그라운드에서 자동화해야 합니다.

[제가 사용하는 자동화 세팅 값] 

옵시디언 설정 > Obsidian Git 메뉴로 들어갑니다.

  • Vault backup interval (minutes): 30 (30분마다 자동으로 커밋하고 푸시합니다.)

  • Pull updates on startup: 활성화 (옵시디언을 켤 때마다 깃허브 서버에서 최신 변경 사항을 자동으로 다운로드합니다.)

  • Push on vault close: 활성화 (옵시디언 앱을 종료할 때 마지막으로 모든 변경 사항을 서버에 올립니다.)

이 세팅만 해두면, 여러분은 평소처럼 글만 쓰면 됩니다. 백업과 동기화는 옵시디언이 알아서 조용히 처리해 줍니다. 노트북을 켜서 옵시디언을 실행하면, 알아서 최신 파일(Pull)을 불러와 주니 기기 간 전환도 매끄럽습니다.

5. 주의사항 및 모바일 환경의 한계

이 시스템의 유일한 한계점은 '스마트폰(모바일) 동기화'가 까다롭다는 점입니다. PC나 노트북(윈도우, 맥북) 간의 동기화는 이 방법으로 100% 무료 완벽 구축이 가능합니다.

하지만 아이폰이나 안드로이드폰의 옵시디언 앱은 깃허브와 직접 연동하는 것이 제한적입니다. 아이폰의 경우 'Working Copy'라는 유료 앱을 거쳐야 하고, 안드로이드는 'Termux'라는 개발자 앱을 통해 우회해야 합니다.

만약 "나는 PC로만 작업하고 백업이 주 목적이다" 혹은 "PC와 노트북 2대만 왔다 갔다 한다"라면 이 깃허브 연동이 최고의 선택입니다. 하지만 "나는 지하철에서 스마트폰으로 메모를 꼭 해야 한다"는 모바일 헤비 유저라면, 정신 건강을 위해 공식 '옵시디언 싱크'를 결제하거나, 모바일과 호환성이 상대적으로 나은 '아이클라우드(애플 생태계 한정)' 동기화를 차선책으로 고려하시길 권장합니다.

[핵심 요약]

  • 구글 드라이브 같은 일반 클라우드는 옵시디언 설정 파일과 충돌을 일으키기 쉬우므로, 버전 관리가 가능한 깃허브(GitHub)가 가장 안전한 무료 백업처다.

  • 깃허브 저장소를 생성할 때는 개인정보 보호를 위해 반드시 'Private(비공개)' 모드로 설정해야 한다.

  • Obsidian Git 플러그인의 자동 백업 간격과 시작 시 자동 다운로드(Pull) 기능을 켜두면, 별도의 조작 없이도 PC 간 매끄러운 동기화가 유지된다.

[다음 편 예고] 

든든한 백업 시스템까지 갖추었으니 이제 생산성을 폭발적으로 끌어올릴 차례입니다. 다음 10편에서는 코딩 없이도 복잡한 문서 양식을 자동으로 뚝딱 만들어주는 마법 같은 도구, "템플리터(Templater) 플러그인으로 반복적인 양식 작성 자동화하기"를 알아보겠습니다.

[댓글 질문] 

여러분은 과거에 하드디스크나 클라우드 오류로 중요한 문서(과제나 업무 파일)를 날려버린 뼈아픈 경험이 있으신가요? 여러분만의 백업 철칙이 있다면 공유해 주세요!

댓글

댓글 쓰기

이 블로그의 인기 게시물

침대에서 누워서 노트북 하기, 스트럭쳐랩 올인원 플로우 스탠드 내돈내산 실사용기

이미지
퇴근하고 씻고 누우면 다시 일어나서 책상 앞에 앉기가 참 쉽지 않죠. 저 역시 침대 위에서 모든 걸 해결하는 '베드 스테이션'을 꿈꾸며 누워서 쓸 수 있는 스탠드를 찾다가, 쿠팡에서 허리디스크 환자분이 누워서 쓰기 좋다는 후기를 보고 '스트럭쳐랩 올인원 플로우 스탠드'를 들여왔습니다. 결론부터 말씀드리면, 몇 달간 제 침대 옆을 지켜주고 있습니다. 직접 써보면서 느낀 찐 장단점을 솔직하게 정리해 볼게요. 내가 이 기기에 꽂힌 이유 저는 평소에 누워서 노트북이나 태블릿을 편하게 조작할 수 있는 환경에 진심인 편이에요. 처음엔 '누워서 쓰다가 노트북이 내 얼굴로 떨어지면 어쩌지?' 하는 공포감이 제일 컸습니다. 하지만 침대 사이드에 세워두고 완전히 누운 상태에서 화면을 아래로 내려다볼 수 있는 기가 막힌 수직 각도를 지원한다는 점, 그리고 튼튼한 알루미늄 소재라는 점에 꽂혀서 바로 결제했습니다. 색상도 칙칙한 블랙 대신 깔끔한 실버라 방 인테리어와도 잘 어울렸어요. [사진 출처 : 제품 공식 상세 페이지] 며칠 써보며 느낀 찐 장점 직접 15인치 노트북을 물려놓고 써보면서 느낀 가장 큰 장점들은 이렇습니다. 절대 얼굴로 떨어지지 않는 각도 설계: 보통 노트북 거치대는 아래를 받쳐주는 '턱'이 있어야 안전하다고 생각하잖아요? 그런데 이 제품은 집게 부분에 턱이 없습니다. 처음엔 불안했는데, 막상 써보니 노트북이 쏟아질 만한 각도까지만 딱 세워지도록 락(Lock)이 걸려 있는 방식이라 전혀 위험하지 않았어요. 15인치 무거운 노트북을 달아놔도 불안한 적이 한 번도 없었습니다. 턱이 없어서 편한 타이핑: 오히려 턱이 없다는 게 신의 한 수였어요. 누워서 자판을 칠 때 양쪽 끝에 걸리는 게 없으니까 너무 편하더라고요. 미세한 각도 조절 (스위블): 노트북 거치 부분이 돌아갑니다. 아예 90도로 꺾여서 돌아가는 건 아니지만, 옆으로 살짝 누웠을 때 화면을 내 쪽으로 미세하게 틀 수 ...
자세한 내용 보기

옵시디언 필수 마크다운 문법 총정리 (체크박스, 링크, 텍스트 양식)

이미지
 옵시디언(Obsidian)을 처음 설치하고 빈 화면을 마주하면 막막함이 앞섭니다. 화려한 플러그인이나 복잡한 세팅 이전에 가장 먼저 익혀야 할 것은 바로 글을 구조화하는 '마크다운(Markdown)' 문법입니다. 제가 처음 기술 블로그 글쓰기와 아이디어 정리를 위해 옵시디언을 도입했을 때, 이 기초 양식들을 손에 익히는 것만으로도 작성 속도가 비약적으로 상승하는 것을 경험했습니다. 마우스로 서식 버튼을 누를 필요 없이 키보드 위에서 모든 문서 작업이 끝나기 때문입니다. 오늘은 옵시디언에서 가장 자주 쓰이고 실무에 직결되는 필수 양식(체크박스, 내부/외부 링크, 강조 등)을 완벽하게 정리해 드리겠습니다. 1. 텍스트 강조 및 기본 포맷팅 문서의 가독성을 높이기 위해 텍스트의 형태를 변경하는 가장 기본적인 양식입니다. 굵게 (Bold): 텍스트 양쪽에 별표 두 개(**)를 입력합니다. 작성 예시: ** 중요한 내용입니다.** 기울임 (Italic): 텍스트 양쪽에 별표 한 개(*) 또는 밑줄(_)을 입력합니다. 작성 예시: *강조하고 싶은 말* 취소선 (Strikethrough): 텍스트 양쪽에 물결표 두 개(~~)를 입력합니다. 작성 예시: ~~수정 전 내용~~ 하이라이트 (Highlight): 텍스트 양쪽에 등호 두 개(==)를 입력합니다. 옵시디언 특유의 형광펜 효과를 줍니다. 작성 예시: 이 부분은 ==핵심 키워드== 입니다. 처음엔 기호가 헷갈릴 수 있지만, 일주일만 꾸준히 써보면 손가락이 자동으로 반응하게 됩니다. 특히 블로그 포스팅 초안을 잡을 때, 하이라이트(==) 기능으로 나중에 수정해야 할 문구를 눈에 띄게 표시해 두면 유용합니다. 2. 생각의 구조화: 목록과 할 일 관리 (체크박스) 복잡한 정보를 다루거나 프로젝트 일정을 정리할 때 빠질 수 없는 기능입니다. 순서 없는 목록 (Bullet Points): 하이픈(-) 또는 별표(*) 뒤에 띄어쓰기를 한 번 하면 생성됩니다. 탭(Tab) 키를 누르면 하위 목록으로 들어갑니다....
자세한 내용 보기