Obsidian Git

[!tldr] 한줄 요약 Obsidian 내에서 Git 버전 관리(자동 커밋, pull/push, diff, history)를 통합하는 커뮤니티 플러그인

핵심 내용

개요

• 저장소: Vinzent03/obsidian-git (9.8k+ stars)
• 최신 버전: 2.37.1 (2026-02-15)
• 라이선스: MIT
• 원 개발자 denolehov가 시작, 2021년 3월부터 Vinzent03이 관리

3가지 핵심 뷰

Source Control View — git status + 스테이징 UI

• 파일별 stage/unstage, discard, diff 보기
• 리스트 뷰와 트리 뷰 전환 가능
• push/pull, commit, commit-and-sync 버튼 제공

History View — git log UI

• 최근 커밋 목록 브라우징
• 커밋을 펼치면 변경된 파일 목록과 diff 확인

Diff View — 변경 사항 비교

• 파일의 수정 전/후를 시각적으로 비교
• 에디터 내 줄 단위 추가/수정/삭제 표시 (데스크톱 전용)
• 인라인 sign에서 바로 stage/reset 가능

Line Author (git blame)

에디터에서 각 줄의 마지막 수정 시점과 작성자를 표시하는 git blame 기능을 내장한다.

자동 백업 (3가지 트리거)

[!tip] 자동 백업은 기본적으로 비활성화 상태 설치 후 Settings > Obsidian Git에서 백업 간격을 직접 설정해야 동작한다.

커밋 메시지 템플릿

moment.js 날짜 포맷 플레이스홀더를 지원한다. 예: vault backup: {{date}}

주요 커맨드

인증 방식

모바일 지원 (isomorphic-git)

네이티브 Git 대신 JavaScript로 재구현한 isomorphic-git을 사용한다.

[!warning] 모바일 제한사항

• SSH 인증 미지원
• 큰 저장소에서 메모리 부족/크래시 위험
• rebase 머지 전략 불가
• 서브모듈 미지원

서브모듈 지원 (v1.10.0+, 데스크톱 전용)

• commit-and-sync, pull 시 서브모듈 자동 업데이트
• 재귀적 업데이트 지원
• 서브모듈이 브랜치에 checkout되어 있고 tracking branch가 설정되어 있어야 동작

플랫폼별 참고

예시

자동 백업 + 수동 커밋을 병행하는 설정:

# 자동 백업 설정 (Settings > Obsidian Git)
Vault backup interval: 30        # 30분마다 자동 backup
Auto pull on startup: ON         # 시작 시 원격 변경 자동 pull
Commit message: vault backup: {{date}}  # 자동 커밋 메시지

# 수동 커밋은 Command Palette에서
Git: Commit with specific message  # 의미 있는 커밋 메시지로 수동 커밋

[!example] 자동 vs 수동 커밋 구분 자동 백업 커밋은 vault backup: 2026-02-18 형태로, 수동 커밋은 📝 til: ... 형태로 구분하면 히스토리를 깔끔하게 관리할 수 있다.

참고 자료

• GitHub - Vinzent03/obsidian-git
• Obsidian Git 공식 문서
• Features 문서

관련 노트

• Community Plugins - 커뮤니티 플러그인 생태계
• Vault - Obsidian의 로컬 파일시스템 기반 저장 구조
• Plugin 개발 - Obsidian 플러그인 개발 기초