Introduction to Obsidian
Obsidian 是一款强大、本地优先的知识库与笔记软件,基于 Markdown,直接运行在本地。 它的核心设计理念是帮助你整理思绪、构建个人知识网络,并打造一个数字化的“第二大脑”。
使用 Obsidian Git 同步笔记
1. 创建 GitHub 仓库
首先登录 GitHub。
点击右上角 New Repository。
填写仓库信息:
- Repository name:例如
Obsidian - Visibility:Public 或 Private(推荐 Private)
- 不要勾选:
- Add a README
- Add .gitignore
- Choose a license
然后点击
- Create repository
创建成功后会得到一个仓库地址,例如:
https://github.com/yourname/Obsidian.git后面需要使用它。
2. 安装 Git
如果电脑尚未安装 Git,请前往:
下载安装即可。
安装完成后打开终端:
git --version如果输出类似:
git version 2.50.0说明安装成功。
3. 创建 Obsidian Vault
打开 Obsidian。
点击
Create new vault
例如:
D:\Obsidian\Knowledge以后所有笔记都会放在这个目录。
4. 初始化 Git 仓库
打开终端(PowerShell 或 CMD)。
进入 Vault:
cd D:\Obsidian\Knowledge初始化 Git:
git init连接远程仓库:
git branch -M main
git remote add origin https://github.com/yourname/Obsidian.git查看是否成功:
git remote -v输出类似以下,说明连接成功。
origin https://github.com/yourname/Obsidian.git在知识库D:\Obsidian\Knowledg文件夹下新建第一个笔记
返回powershell并手动推送到远端(仅此次需要)
git add .
git commit -m "first obsidian commit"
git push -u origin main一会过后如果 GitHub 仓库页面出现你的笔记文件,就说明配置成功。
6. 安装 Obsidian Git 插件
打开
Settings → Community Plugins
关闭 Safe Mode。
点击
Browse
搜索:
Git安装并启用。
7. 配置插件
进入:
Settings → Obsidian Git
推荐开启:
Auto Pull on startup
启动时自动拉取最新内容。
Auto Backup
自动 Commit。
Auto Push
自动 Push。
例如:
Auto Backup Interval
设置:
10表示每 10 分钟自动提交一次。