背景

某天上午像往常一样打开语雀准备开始做今日计划时，发现它转了一会加载不出来。刚开始我以为是客户端长时间挂着卡住了或者网络出了问题，尝试退出重进和重连 WiFi 后都没有用。同样，网页端官网也是 404 的状态。于是我在网上简单搜索了下，之前应该也出现过类似情况。我了解到语雀没有存在本地的缓存文件可以访问，这下我的知识库都看不到了！😖这个问题貌似是在第二天才被解决。

突然想起不久前在小红书有看到飞书支持 markdown 的消息，本来打算等语雀恢复正常了，可以考虑把知识库迁移到飞书。继印象笔记 -> Notion 之后，我使用过一段时间的飞书，总体来说它功能和多维表格做的很不错，但是作为一款办公软件，它的入口进来页面设计得很繁杂臃肿，我想要使用的是一款纯粹的知识库笔记软件，另外也避免自己创作的内容在云端泄露隐私以及被割韭菜，也不用担心服务崩溃后无法访问/存在数据丢失问题。

Obsidian - 黑曜石这款软件并不是第一次听说了，实际上它在我的电脑上躺了一段时间，一开始下载下来我并没有花费太多的时间摸索，直接选择了语雀。它可以给我的安全感就是数据全都是离线存储在本地文件夹的 markdown 文件等。我拥有绝对的数据管理权限，最大的数据同步问题也可以使用 iCloud 解决（Apple 全家桶适用），目前官方的数据同步服务需要付费，年费 Sync Plus 是 $8/月)。

导出语雀知识库

语雀个人免费账户目前没有导出整个知识库为 markdown 合集压缩包的功能，只有 PDF。帮助文档中也能看到大家的讨论，文档比较多时导出 PDF 也有问题，导出 markdown 的功能似乎是高级会员才有，免费用户的批量导出 markdown 功能已经被砍掉了🤏🏻。

我在 GitHub 上找到了一个 Star 数比较高的语雀知识库导出开源项目：github.com/gxr404/yuque-dl。经过测试效果还是非常不错的，保留了文件夹结构和图片批量下载收集，它还会自动修改 Markdown 里的图片链接指向本地路径。工具安装和使用方法如下。

安装必备环境 (Node.js)

yuque-dl 是基于 Node.js 编写的工具。下面演示的环境使用的是 MAC，如果你的电脑上还没有安装 Node.js，可以通过 brew 来一键安装（Windows 用户见项目说明）。

打开 Mac 的“终端（Terminal）”，输入以下命令：

1

brew install node

（安装完成后，输入 node -v 看看有没有显示版本号，有的话就代表成功了。）

安装 yuque-dl 工具

环境装好后，直接在终端里使用 npm（Node.js 自带的包管理器）全局安装该工具：

1

npm i -g yuque-dl

获取“专属通行证 (Token)”

由于要下载的是语雀个人账号下的私密知识库，工具需要知道“你是谁”，这就需要获取浏览器里的登录 Cookie (_yuque_session)。

1. 在电脑浏览器（推荐使用 Chrome 或 Edge）中，正常打开并登录语雀网页版。
2. 按下快捷键 Option + Command + I（或者在网页空白处右键点击“检查/Inspect”），打开开发者工具。
3. 在弹出的开发者面板顶部标签栏中，点击 Application (应用)（如果看不到，点击顶部的 >> 展开更多选项）。
4. 在左侧菜单找到 Cookies，点击展开，选中 https://www.yuque.com。
5. 在右侧的列表中，找到 Name (名称) 为 _yuque_session 的这一行。
6. 双击它对应的 Value (值)，这会是一大串很长的乱码字符串，把它完整复制下来。

！！！警告：这串代码等同于你的账号密码，请不要发给任何人。

一键下载知识库

现在，回到“终端 (Terminal)”，找一个想要保存笔记的目录。比如我们把它保存在桌面的一个新文件夹里：（使用 iCloud 做数据同步可以在访达 -> iCloud 云盘下新建一个文件夹作为）

1

cd ~/Desktop

然后，组装并运行你的下载命令！命令的格式如下：

1

yuque-dl "知识库主页链接" -t "复制的_yuque_session值" -d "目标文件夹名称"

实际操作示例： 假设知识库网址是 https://www.yuque.com/zhangsan/plan，Token 是 abc123xxx，想要保存的目标文件夹名称是 YuqueBackup ，输入以下命令即可：

1

yuque-dl "https://www.yuque.com/zhangsan/plan" -t "abc123xxx" -d YuqueBackup

见证奇迹的时刻！

按下回车后，终端里会出现非常漂亮的进度条。yuque-dl 会自动开始：

1. 抓取你知识库里的完整目录树。
2. 自动按照语雀里的层级，在你的电脑上建立对应的多级文件夹。
3. 把所有的文档转换为纯 .md 文件。
4. 最棒的一点：它会自动把语雀 CDN 服务器上的图片全部下载下来，并自动修改 Markdown 里的图片链接指向本地路径！

等待进度条跑完（100%），就可以关闭终端了。

迁移到 Obsidian

此时，桌面上已经有了一个名为 YuqueBackup 的文件夹。里面的数据结构极其完美。 现在只需要打开 Obsidian -> 选择 “打开文件夹作为库（Open folder as vault）” -> 选中 YuqueBackup 文件夹。

至此，该方法已经成功冲破了语雀的权限封锁，带着所有图片和层级结构，安全抵达了纯本地的 Obsidian 世界！

Obsidian 必装插件分享

核心排版与编辑体验

• Editing Toolbar

  • 作用：像 Word 或语雀一样，在顶部给你提供一个可视化的富文本工具栏。加粗、调色、居中、插入表格，只需点一下，再也不用死记硬背 Markdown 语法了。

• Advanced Tables

  • 作用：原生 Markdown 的表格非常难看且难对齐。这个插件能让你像在 Excel 里一样，按 Tab 键自动生成下一列，按 Enter 键自动对齐表格，极其舒适。

• Image auto upload Plugin (配合 PicList / PicGo)

  • 作用：你从网页上复制一段带图的文字，或者截图直接粘贴（Cmd + V）时，它会自动帮你把图片上传到图床（如阿里云、腾讯云等），只在笔记里留一个链接。这对保持本地文件夹清爽极其重要。

文件管理与展示

• Folder Note

  • 作用：允许你像语雀一样，点击一个文件夹不仅仅是展开目录，而是会打开一篇关于这个文件夹的“主页介绍文章”。

• Outliner

  • 作用：如果你喜欢像幕布、Workflowy 那样做大纲笔记，这个插件能让你用快捷键随意拖拽、折叠缩进列表节点。

进阶神器（先收藏，以后慢慢学）

• Dataview

  • 作用：Obsidian 的灵魂插件！它能把你的所有笔记变成一个数据库。比如你可以写一行代码，自动汇总出所有标签为 #读书笔记 且评分为 5 星的文章列表。

• Excalidraw

  • 作用：无缝内嵌一个手绘风格的白板，可以直接在 Obsidian 里画流程图、思维导图，还能双向链接你的文字笔记。

文章内悬浮大纲

• Floating TOC
  • 作用：在文章的右侧/左侧生成一个半透明的悬浮小气泡。鼠标移过去，大纲就会弹出来；鼠标移走，大纲就隐藏（也可以固定显示）。极大地节省了屏幕空间，非常优雅。

提升颜值的极简主题

外观装修三剑客：

• Minimal

  • 作用：极简苹果风，提升整体颜值。Minimal 主题是 Obsidian 现任 CEO（网名 kepano）亲自开发的。它是整个 Obsidian 社区下载量最高、评价最好的神级主题，主打的就是极致的“苹果式极简风”和专注打字的沉浸感。

• Minimal Theme Settings

  • 作用：Minimal 主题的专属控制台插件，为 Minimal 主题提供了一个专门的控制面板，方便调节各种设置细节。安装并启用后，设置列表左侧会多出一个 Minimal Theme Settings 的专属菜单，可以进行以下调整：
    • Color scheme（色彩模式）：可以把暗色模式设为纯黑（True black，特别省电），把亮色模式设为有点护眼纸张质感的颜色（比如 Things 或 Nord 风格）。
    • Colorful headings（彩色标题）：强烈建议打开！ 开启后，H1、H2、H3 标题会自动变成不同的低饱和度颜色，层级分明，再也不用像原生那样全是死板的黑字了。
    • Text width（文本宽度）：如果觉得现在的行宽太宽了（眼睛左右扫视很累），可以在这里把 Normal line width 调小一点（比如调成 40 ），文字就会像公众号文章一样居中排版，阅读极度舒适。

• Style Settings

  • 作用：它是一个“可视化的外观控制台”，让你不需要写一行代码（CSS），就能傻瓜式地定制主题的每一个细节。 Style Settings 插件本身是不提供任何样式的。它必须配合 支持它的第三方主题（比如 Minimal、Blue Topaz、AnuPpuccin 等）一起使用才会生效。例如这里我们需要修改 Minimal 主题的各级标题颜色就要用到它。

Minimal 主题的彩色标题色彩组合分享

在写文章的时候，我倾向于那种极客风格的色调（例如"#8AB4F8 极客蓝"、"#81C995 薄荷绿"。），但是需要注意确保各级标题区分明显而又不能弱化重要的低级标题。例如正文里通常用明显的二级标题划分主题，三级标题显示主题下的各级分类，三级标题下是主要的核心内容，再往下的四级标题通常是子类具体内容，后面的五六级标题通常是基于四级标题做长文本和再分类区分的。

以下这套配色的灵感来源于目前全球最受欢迎的顶级代码编辑器（如 VS Code 的 One Dark Pro 和 GitHub 现代主题）。 它的核心原则是：亮色模式下颜色极度清透扎实，暗色模式下拥有代码高亮般的荧光质感，且低级标题绝不隐形。

💻 【Cyber IDE】全层级配置对照表

操作指南： 安装完上述的“外观装修三剑客"之后，在Obsidian 的 Style Settings 中，展开到 Level 1 Headings，看到 H1 text color：

1. 点开上面那行的颜色圈，把 #1E232D 粘进去回车。
2. 点开下面那行的颜色圈，把 #F0F6FC 粘进去回车。
3. 往下划，找到 Level 2 Headings，重复复制 H2 的颜色… 直到 H6。

亮色主题显示效果

深色主题显示效果