语雀心碎用户

事情的起因， 就是 2023 年 10 月 23 日语雀崩了，还崩了几小时 语雀的P0事故，虽然那段期间我没用语雀，但不免担心万一语雀突然凉了咋办，毕竟玉伯走了，还有钉钉文档这样的竞品，加上这次事故处理这么久，产生了信任危机，虽然后来做了复盘并补偿了 6 个月会员，但信任这种东西一旦崩塌就很难重新建立的，所以下定决心做一次迁移。

迁移到哪儿，目前其实就 3 个选择：

• notion
• Obsidian
• 思源

这几个笔记本都满足我基本的需求：写 markdown， 支持图床。但在很久之前就从印象笔记迁移到语雀了，当时印象笔记对 markdown 的支持特别差，反馈了 bug 都从不解决，当时还有一年多会员没用，于是当时就迁移了一次到语雀。notion 的功能特别强大，迁移 notion 应该是最简单，但为了避免将来又要搞一次，所以就不考虑 notion，思源和 Obsidian 都差不多，思源的上手曲线相对 Obsidian 简单些，但其文件格式非 .md，为了数据本地化更完整，最终选择 Obsidian，整体迁移思路如下：

从语雀导出所有笔记和图片

当然不可能一个个从语雀手动拷贝出来，断断续续也有百来篇笔记，所以就得考虑用工具来处理，想起当初语雀开始收费的时候，天猪写了一个脚本来着，然后抓紧翻出来看：如何看待语雀付费策略？，里面提到他写了一个 工具 来处理这事，于是直接下载下来使用，但发现运行起来报了各种该错误，折腾了一下没解决（这个方案需要用官方的 token，使用 token 要花钱。。。），于是重新找了一个工具：GitHub - renyunkang/yuque-exporter: A tool for exporting Yuque documents as markdown.

这个工具运行起来也是报错，但好在作者使用 chatgpt 写的，错误比较容易处理，而且采用的无头浏览器调用网页版的导出功能，不需要额外花费，于是就用这个了

改后可以运行的脚本放在：GitHub - zaiMoe/moveout-yuque: 语雀心碎用户 注意，需要用 node@16 运行

导出图片的脚本我也用 chatgpt 写了一个 node 版本，运行：npm run replace 就行

上传图床

最终选择的方案是阿里云的 oss，相比腾讯 cos 便宜些，也比放在自己的服务器靠谱。 最终方案： 阿里云 oss + picgo

阿里云 oss 设置

首先购买一个资源包，这个可以用于存储和上传

其次看个人需求是否购买流量包，这个是用于访问 oss 资源时的流量费用。对于个人笔记本来说，访问量很小，就不需要开了，有一定的免费额度，即使收费也不贵

购买后就可以创建一个 bucket，主要设置就是下面两项，其他的按需开，要收费的就不建议使用了。

配置 oss 权限

到 阿里云的访问控制 中，创建一个子用户，并未这个账户添加 oss 的权限

注意，创建成功的时候会显示 AccessKey ID 和 AccessKey Secret ，记得复制下来

然后在回到 bucket 授权策略 中，配置好访问权限

本地图片上传图床

虽然 Obsidian 的 image-auto-upload-plugin 插件支持自动将本地文件上传到图床并替换代码中的图片，但任然需要一个个的替换，文件太多了，手动是不可能手动的，于是又用 chatgpt 写了一个工具，同样在项目中运行： npm run upload，当然需要改一下代码中一些配置

Obsidian 调试

这里主要做 2 件事情：

1. 多端同步
2. 图床使用
3. 个人偏好设置

多端同步

个人笔记本，就直接同步到 github 或者 gitee 就行，创建相关仓库并把文件上传上去之后，在 Obsidian 中安装 obsidian-git 插件，然后设置下同步方案即可，因为我同一时间只会用一台设备，所以不用考虑过于频繁的提交，其他的按需设置：

对了，在首次提交之前，记得补充一个 .gitignore 文件，其中内容：

.obsidian/workspace # 忽略本地个人喜好的配置

接着可以在右上角找到这个工具，这里就像 vscode 的面板了，不详细介绍

如果没有可以按下： Ctrl + P 搜索 git 手动打开

图床配置

配置 Picgo

• keyid: 就是上面创建子用户的 AccessKey ID
• keySecret: 即 AccessKey Secret
• 设置 bucket 和 设定储存区域：打开 bucket 的 基本信息阿里云登录页 页面
• 设置 bucket 和 设定储存区域：打开 bucket 的 基本信息 页面，分别对应这两个部分

其他的可以不填。

然后上传一张图片测试，没问题的话就能在 bucket 中看到你上传的图片了。

Obsidian 自动上传图片

子需要安装 image-auto-upload-plugin 这个插件，然后上面都不要修改即可。

上面说到，这个插件支持将单个文件中的图片上传，其方法是，按下 ctrl+p ，搜索 upload

个人偏好设置

这一块因人而异了，我本身只是需要一个好用的 markdown 编辑器，所以不想花费太多时间研究各类插件、主题。所以这里之推荐几个我觉得还不错的插件：

Obsidian Linter （强烈推荐）

markdown lint 插件，虽然 Obsidian 本身是类似 Typro 那种同步渲染的，但这种模式下，源 markdwon 格式可能会很乱，而且为了保证一些书写习惯还得自己记忆，比如我习惯单词、数字前后有空格，这个插件就非常适合了，能让我更加专注写文档而不用考虑样式，因此十分推荐

安装完成之后，除了默认设置，建议开启下面几个：

另外单词拼写检查可以在这里开启，不需要在这个插件中开启了

Obsidian Auto Link Title

粘贴链接会自动显示链接标题，非常好用。

Advanced Tables for Obsidian

表格美化，写 markdown 的同学都知道表格多麻烦

obsidian-editing-toolbar Plugin

就是一个工具栏，很多快捷键记不住，方便使用

总结

为了笔记数据的安全，从语雀迁移到了 Obsidian 中，本身只是需要一个能舒服写 markdown 的编辑器，因此不要太多折腾就达到了要求。所以如果写作需求比较小，可以尝试这种简易的方案，通过一些插件，写 markdown 体验会挺好的，当然如果不想折腾就直接用 notion 吧