我一直是Typora的忠实用户，享受它简洁的编辑体验，并通过云盘和NAS进行同步。然而，自2021年11月Typora 1.0版本发布并转向收费模式后，我开始重新思考我的笔记工具选择。虽然网上有各种破解教程，但我更希望找到一个长期可持续的解决方案。

在经过多方对比后，我最终选择了Obsidian。它吸引我的核心优势在于：

• 数据完全自主：笔记以本地Markdown文件存储，即使软件停止服务，也可用任何Markdown编辑器继续使用
• 云端同步灵活：可结合GitHub实现自动备份，相比云盘/NAS的手动同步更加便捷
• 极致流畅体验：切换笔记、打开新窗口几乎无卡顿，有效保持工作心流
• 丰富的扩展性：插件生态系统强大，可定制性极高

下面我将分享Obsidian的安装、配置以及使用GitHub进行云同步的完整流程。

一、下载与安装

Obsidian提供全平台客户端，访问官网即可下载：
Obsidian官网下载页面
Windows用户直接点击“Download for Windows”，安装过程非常简单，只需按照向导一步步完成即可。

二、配置GitHub云同步

1. 创建GitHub私有仓库

首先登录GitHub，点击绿色的 New 按钮，创建一个repository，也就是存储库，用于存储我们的md文件

这里我们要设置仓库名称，为了方便记忆，我选择使用“personal-note”。然后在Choose visibility建议选择“Private”（私有仓库），这样你的笔记才不会公开在互联网上。

点击“Create repository”后，你的专属笔记仓库就创建完成了。

2. 克隆仓库到本地

接下来我们需要把这个仓库克隆到本地。熟悉命令行操作的可以直接使用，对于不熟悉命令行的用户，推荐使用GitHub Desktop进行图形化操作：

Github Desktop是官方推出的一款完全图形化、对小白极为友好的工具，详细下载安装教程可以参考我的另外一篇文章
告别命令行！使用GitHub Desktop图形化下载和管理项目（小白友好教程）

打开GitHub Desktop，点击“File” → “Clone Repository”：

选择刚才创建的仓库，并设置本地存储路径，然后点击“Clone”：

3. 在Obsidian中打开仓库

启动Obsidian，选择打开本地仓库，找到刚才克隆的本地仓库文件夹并打开：

现在你就可以开始创建笔记了！每个笔记都会保存为标准的Markdown文件，直接存储在本地仓库文件夹中。

4. 配置.gitignore文件

Obsidian会自动生成一个.obsidian文件夹，其中包含软件配置。其中 workspace.json 会记录当前工作区的状态，例如当前的页面布局，所打开的笔记等。

为了避免同步冲突，我们需要将工作区状态文件排除在Git管理之外。

在仓库根目录创建.gitignore文件，添加以下内容：

# 排除工作区状态文件，避免频繁更改导致冲突
.obsidian/workspace.json
.obsidian/workspace-mobile.json

5. 首次手动同步

回到GitHub Desktop，你会看到所有新建的文件。勾选它们，填写提交描述（如“初始化”），然后点击“Commit 5 files to main”：

接着点击“Publish branch”，将本地更改推送到GitHub：

现在访问GitHub网页端，确认文件已成功同步，此时我们已经成功将我们电脑上的本地笔记库通过GitHub进行了一次云同步

三、设置自动同步

手动提交虽然可行，但长期使用颇为繁琐。幸运的是，Obsidian有强大的插件系统可以解决这个问题。

1. 安装Git插件

进入Obsidian设置 → 第三方插件，关闭安全模式：

然后在社区插件市场中搜索“Git”插件：

找到后点击安装并启用：

2. 配置自动同步

进入Git插件设置，建议调整以下选项：

• 开启自动提交与同步：启用“Auto commit-and-sync after stopping file edits”
• 设置同步间隔：将“Auto commit-and-sync interval(minutes)”改为1（表示停止编辑1分钟后自动同步）
• 启动时拉取更新：开启“Pull on startup”，确保每次启动时获取最新更改

3. 测试自动同步

现在，当你编辑笔记并停止1分钟后，Obsidian会自动触发同步。首次使用可能需要GitHub身份验证：

验证成功后，右上角会显示同步状态：

再次检查GitHub仓库，确认更改已自动同步：

四、进阶功能预告

至此，你已经搭建了一个自主、安全且自动同步的笔记系统。但Obsidian的魅力远不止于此：

• AI集成：结合智能助手提升写作效率
• 多端同步：手机端随时记录与查看
• 知识图谱：可视化笔记间的关联，构建个人知识网络
• 多样化导出：支持PDF、HTML等多种格式
• 图标分类存储：图片自动分类存储，笔记重命名或移动时，附件文件夹及链接自动更新

这些高级功能我将在后续文章中详细分享。现在，你已经拥有了一个完全属于自己、数据自主、同步便捷的笔记系统，告别了软件收费的顾虑，也享受到了比Typora更流畅的编辑体验。

开始你的Obsidian之旅吧，如有任何问题，欢迎在评论区交流讨论！

小贴士：定期检查GitHub仓库的存储空间（私有仓库有一定限制），重要资料建议本地多重备份。