在日常工作和学习中,我们常常需要跨设备同步笔记。虽然有许多专业的云笔记服务,如 Notion、印象笔记等,或者可以借助网盘和云盘工具来实现笔记共享,但这些解决方案往往存在一些限制:要么需要付费,要么需要安装专门的软件,甚至有些还要求额外购买实体设备。那么,对于那些不介意动手的程序员来说,是否存在一种既免费又灵活,同时又能轻松搭建的私有云笔记解决方案呢?
答案是肯定的。作为程序员,我们对 Git 这样的工具非常熟悉,它是代码提交和项目管理中不可或缺的工具。而 Markdown 作为一种简洁高效的文档格式,已经成为日常编写文档的标准(例如 Git 项目中的 README.md
文件)。通过将这两者结合,我们完全可以打造出一个属于自己的私有云笔记系统。
事实上,GitHub 本身不仅仅是一个代码托管平台,它还可以作为一个优秀的资源暂存库。 借助 Git的版本控制和同步功能,我们能够方便地管理和同步笔记内容,实现跨设备访问,并且可以随时查看、恢复历史版本。而且,Git提供的免费套餐已经足够支持个人的需求,因此可以说,它是打造私有云笔记的理想平台之一。接下来,我将以 Gitee+ Typora 作为示例,详细说明如何实现:
1. 安装Typora(已有可跳过)
- Typora需要收费,不想付费可以找破解版或使用
Mark Text
等平替
2. 安装Github(已有可跳过)
- 自定义安装、默认安装均可
- 安装完成后
- 命令行执行
git --version
确认是否安装成功 - 任意位置右击验证是否有open git bash here选项
- 命令行执行
3. 登录Gitee创建远程笔记仓库
登录Gitee创建一个专门存放笔记的仓库如cloud-notes(Gitee国内友好,Github也可以前提是要确保能访问)
- 公开还是私有需自行权衡:如果你的笔记需要被其他人查看、分享、clone或者协同更新,选择公开;如果你的笔记涉及个人隐私信息、敏感信息,建议选择私有
- 记住远程仓库地址
https://gitee.com/[yourGiteeUsername]/[your-cloud-notes-name].git
后面需要用到
4. 配置SSH KEY实现Gitee免登录(已有可跳过)
-
右击任意位置打开
open git bash here
-
执行
ssh-keygen -t rsa -b 4096 -C "yourEmail" -f C:\Users[yourPCUserName].ssh\id_rsa_github
命令,执行后会在C:\Users[yourPCerName].ssh
下生成两个文件,分别是:C:\Users[yourPCUserName].ssh\id_rsa_github
#(私钥)C:\Users[yourPCUserName].ssh\id_rsa_github.pub
#(公钥)
-
用记事本打开
C:\Users[yourPCUserName].ssh\id_rsa_github.pub
,Ctrl+A全选复制 -
登录Gitee,点开头像---->设置---->安全设置/SSH公钥---->复制公钥命名公钥并点击确定保存
-
在刚刚打开的git bash窗口执行
ssh -T git@gitee.com
看到success
这类字眼表示成功 -
继续设置笔记提交的用户信息
- 与gitee登录账户无关,不影响登录及提交,因git支持协同,主要用于标记谁提交的、提交了什么。多台电脑"共享"同一笔记的时候,可以按需设置成不一样的。
shell
git config --global user.name "yourName"
git config --global user.email "yourEmail"
5. 本地新建笔记文件夹及笔记
新建一个文件夹如cloud-notes
专门用于存放你需要的笔记,名称无所谓,可以跟远程仓库一样也可以不一样:
- cloud-notes目录可以创建任意子目录、任意子文件
- 新建一个.md文件如
《Rust学习笔记.md》
保存
6. 修改Typora图像存储路径
Typora图片存储如果不手动设置,win10默认在C盘:C:\Users[yourPCUserName]\AppData\Roaming\Typora\typora-user-images,为了方便管理笔记中用到的图像,并且能够与文字笔记统一、同步上传到云端,需要设置为相对路径:
-
打开
《Rust学习笔记.md》
对Typora进行全局设置,对图像进行如下设置✅复制到指定路径
✅自动创建与笔记同名的文件夹存放图片
✅在笔记中优先使用相对路径
7. 笔记提交
- 进入本地cloud-notes目录
- 右击打开open git bash here
- 执行如下命令
shell
git init
git add .
git commit -m "我的笔记初始化提交"
git remote add origin https://gitee.com/[yourGiteeUsername]/cloud-notes.git # 已添加可跳过
git push -u origin "master"
8. 在其他电脑端拉取笔记
- 参考上述1-6步在其他电脑上设置
- 执行命令将远程仓库的笔记拉取到本地
shell
git pull origin master
9. 在其他电脑端更新笔记后提交笔记
shell
git add .
git commit -m "更新我的笔记了"
git push -u origin "master"
通过 Git 和 Markdown 结合,你可以轻松搭建一个免费的私有云笔记系统,实现跨设备同步和高效管理。记得每次使用笔记前,先拉取最新的内容git pull origin master
,以确保始终编辑的是最新版本。这样,你的笔记将始终保持同步,轻松管理你的知识。