Bước 1. Cài đặt Git trên macos

  • Mở Terminal
  • Kiểm tra xem Git đã được cài đặt chưa bằng lệnh: git --version
  • Nếu chưa cài đặt, bạn có thể cài đặt thông qua Homebrew: brew install git hoặc tải trực tiếp từ trang chủ Git

Bước 2. Cài đặt plugin “Obisidian Git

  • Trong Obsidian, vào Settings (Cài đặt)
  • Chọn mục Community Plugins
  • Tắt chế độ Safe Mode nếu đang bật
  • Tìm kiếm “Obsidian Git” trong phần Browse
  • Cài đặt plugin và kích hoạt nó

Bước 3. Thiết lập repository

  • Tạo 1 repository mới trên tài khoản github của bạn (new)
  • Mở Terminal và điều hướng đến thư mục vault của Obsidian: cd đường_dẫn_đến_vault
  • Thực hiện lần lược các câu lệnh sau
    echo "# digital-garden" >> README.md
    git init
    git add README.md
    git commit -m "first commit"
    git branch -M main
    git remote add origin <link your repository>
    git push -u origin main
    
  • Thêm file .gitignore để loại trừ các file không cần thiết

File .gitignore thường được đặt ở thư mục gốc (root) của dự án Git. Đây là vị trí tiêu chuẩn và hiệu quả nhất vì nó sẽ có tầm ảnh hưởng đến toàn bộ dự án, bao gồm tất cả các file và thư mục con trong dự án của bạn - Thêm workspace.json hoặc .obsidian/* (để gitignore toàn bộ thư mục .obsidian trong dự án Obsidian của bạn) vào file .gitignore (đây là một ý tưởng tốt để tránh xung đột) Lưu ý rằng nếu thư mục .obsidian đã được Git theo dõi trước đó, bạn cần phải xóa nó khỏi Git cache bằng lệnh: git rm -r —cached git add . git commit -m “.gitignore is now working” git push

Bước 4. Cấu hình Plugin Obisidian Git

  • Tạo mới Personal Access Token (PAT) để cấp quyền truy cập repo (Setting) Truy cập GitHub → Settings → Developer Settings → Personal access tokens → Fine-grained tokens (hoặc Tokens Classic)
  • Mở Command Palette trong Obsidian (Ctrl/Cmd + P)
  • Chọn “Git: Clone an existing remote repo”
  • Thêm đường dẫn tới repository theo cấu trúc https://[email protected]/hoangphuctran93/my-notes.git
  • Kiểm tra cấu hình Mở Command Palette chọn “Git: Open source control view” thử thực hiện “Pull” hoặc “Push” để kiểm tra kết nối
  • Khởi động lại ứng dụng Obsidian và bắt đầu ghi chú

Xem thêm taị bài viết: https://forum.obsidian.md/t/the-easiest-way-to-setup-obsidian-git-to-backup-notes/51429