Support | 微信 & TG: @scomper

Obsidian 的使用体验

2021.07.31 17:45

接触到 Obsidian 有点相见恨晚的感慨,可说上周才订阅 Bear,然后网友推荐了这个,试用后马上就决定转换到 Obsidian。Obsidian 是一款基于Markdown的知识管理工具,并且开发者承诺对于个人使用者软件永久免费。和 Bear、Ulysses 这类 Markdown 编辑器管理的方式不同,Obsidian 的文档以独立的 md 文件形式存储在自定义文件夹当中,借助 iCloud 在多设备之间同步。

Obsidian 的软件特色

Obsidian给人最直观的主要特性:

  • 网络关系图谱,以图形的方式动态的展示文档之间的内部链接关系;
  • 多栏的编辑器,支持水平和垂直切换窗口,可同时浏览编辑多个文档;
  • 块链接和引用,编辑过程中输入 [[文件名 就能快速关联或者创造一个待关联的其他文档,鼠标悬停在块链接上可以预览内容,还支持嵌入方式进行展现;
  • 双向链接,Obsidian 右侧边栏中的反向链接面板可以显示链接当前文件提到当前文件名的文档,对于梳理文档关系非常有用;
  • 附件管理,支持图片和 PDF 等文件类型的直接拖拽添加,自动添加文件到自定义的附件文件夹;
  • 文件夹和标签,内容组织上大类可以用文件夹,小类用标签,标签支持嵌套模式,例如 标签/标签 2
  • 插件扩展,通过丰富的插件来满足各种多样化的需求,例如:图片实时预览、表格自动化、网页 URL链接转成脚注模式、标签栏有直接编辑标签、清理文档没有引用的图片、自动匹配系统主题、代码高亮等等。

文件库和 iCloud

Obsidian 的文件组织是基于文档库概念的,所以不管是 Obsidian for Mac 端还是 Obsidian for iOS 端,首次登录应用都需要先创建一个文档库来存储文档。可以定义多个文档库来组织不同性质的文档。需要注意的是内部文档链接、引用和块链接不能跨越文档库。

如下图所示,Document 是我命名并创建的个人文档库,而Obsidian Help 是软件自己创建的存储帮助文档的文档库。为了在 Mac 和 iOS 之间同步,个人文档库被我创建到了 iCloud 文件夹当中。

注意:先安装 Obsidian for iOS, 点击「Create new vault」命名并创建一个文档库,例如:Document,然后 Mac 端选择「打开库文件夹」定位到 iCloud 的/obsidian/Documents 文件夹即可。

迁移 md 文件到 Obsidian

在 Obsidian 中创建文件夹后,用 Finder 定位到 Obsidian 的 Documents 文件夹,你会发现文件结构和软件中一样。是的,这也是 Obsidian 吸引人的地方之一,文档存储是完全开放的,其他软件导出的 md 文件直接复制到这里就完成了迁移。


迁移前还有一项工作需要完成,在 Obsidian 中创建好「附件」文件夹,用来保存文档中引用的图片。
直接创建一个新文件夹命名为「附件」,到 Obsidian 设置-文件与链接 中设置其为附件文件夹。

Bear 中的笔记该如何迁移呢?
为了避免导入后需要重新归类文件夹,建议按分类分次导出,导出一批复制一批到对应的 Obsidian 文件夹。

  • 选择分类①,全选当前类的文档;
  • 由菜单栏选择「导出笔记」②
  • 存储对话框中,选择格式为 MarkDown 并 ③勾选导出附件


Bear 勾选导出附件后,会将包含图片单独保存到和文件同名的文件夹当中,md 文件中图片的路径也是这个同名文件夹。迁移分两步完成:

  1. 将图片连同其文件夹移动到 Obsidian/Documents/附件 文件夹当中;
  2. 将导出的 md 文件移动到对应的文件夹,例如 Obsidian/Documents/个人。

导入成功,打开 Obsidian 预览一下文档,检查图片显示是否正常。

输入法的调整

Obsidian 使用上的问题,建议先看看它自带的帮助,介绍非常全面。建议着重阅读一下Obsidian 文档之间的链接的章节, 输入 [[ 就能弹出并搜索关联文档库中的其他文档,自动实现关联。
然而默认输入法输入 [ 符号默认是中文形态的 【,需要切换到英文模式,频繁使用多有不便。好在有「鼠须管」这种可以灵活自定义的输入法。

我使用的是小鹤双拼,所以只需调整一下 double_pinyin_flypy.custom.yaml 并「重新部署」,将左上角的 ~ 键(`)、>、^、[ 等按键改为直接输出。

其他输入方案如果要改造,参照以上修改对应的方案文件即可。

完整代码参照 github.com/scomper/Rime

第三方插件

Obsidian 提供了核心插件和第三方插件来帮助用户实现使用场景上的个性化。
关闭第三方插件的「安全模式」后就能浏览和安装丰富的社区插件。安装后的插件如果包含设置项,同样会出现在设置面板当中,向下滑动左侧设置面板就能看到。

通过调节插件的参数,很多插件能以图标方式出现在编辑器的左侧工具栏上。

  • Advanced Tables,在 Obsidian 中增加了改进的导航,格式化和对 Markdown 表格的操作。
  • Sliding Panes (Andy Matuschak Mode) ,这个插件改变了主工作区中窗格的处理方式-灵感来自于Andy Matuschak笔记中的用户界面。工作区不再缩小以适应面板,面板将保持固定的宽度并堆叠起来,它们之间会随着焦点而自动伸展。和Minimal主题不和谐
  • Editor Syntax Highlight,对代码块进行语法高亮显示。
  • Tag Wrangler,为 Obsidian 标签窗口中的标签增加了一个上下文菜单,方便编辑和重命名标签。
  • Find unlinked files,这个插件会检查你的整个文档库,搜索那些没有任何链接的文件。换句话说,就是没有反向链接的文件。最后,它将创建一个文件,列出这些未链接文件的链接。使用频率偏低
  • Ozan's Image in Editor,插件帮助你在编辑器视图下直接查看图像、iframe 和 PDF 文件,而无需切换到预览模式。
  • Folder Note,为文件夹添加描述说明。生成文件夹的卡片式概览。安装后按住 Ctrl 键点击文件夹名称即可生成卡片概览页面。使用频率偏低
  • Footlinks,将当前文档的所有 URL 链接转成脚注形态,让页面中的 URL 链接显示更干净。使用频率偏低
  • System dark mode,让主题自动匹配操作系统设置的明暗模式。插件Minimal Theme Settings 包含
  • Advanced Obsidian URI,URI 链接支持,快捷指令或其他应用如果想通过 Schema 链接方式和 Obsidian 交互,必装的插件。
  • Clearing Unused Images,这个插件可以帮助你保持你的文档库的清洁,删除你的 Markdown 笔记中不再引用的图片。
  • Word Splitting for Simplified Chinese in Edit Mode,增加 Obsidian 内置编辑器的(简体)中文分词支持,使得编辑模式的双击可以选中中文。比较影响加载速度
  • Minimal主题,显示上优雅多了尤其是iOS端。Minimal 主题还可以另外安装插件Minimal Theme Settings 调整参数,例如字体、自动适配系统暗黑模式等。
  • Calendar,日历插件,点击日期添加笔记,日历上也会标识有笔记的日子。
  • Dataview,非常强大的数据整理插件,可以检索列出想要的笔记、标签和待办事项。
  • Hotkeys++,增加更多的操作热键,比如 ⌘M 待办切换、⇧⌘M 列表项切换等。
  • Outliner,Workflowy 样式的大纲记录,Tab 缩进,Shift + Tab 减少缩进。
  • Recent Files,左栏中增加一个最近文件列表。
  • Show File Path,状态栏上显示笔记的路径。

更多的插件大家根据自己的使用场景慢慢挖掘吧!

浏览器剪藏扩展

Obsidian 是一个本地 Markdown 编辑器,因此你可以将整个网页以 Markdown 的形式保存到 Obsidian 的库中。
Obsidian 推荐的是 MarkDownload 浏览器扩展,可以将网页以 Markdown 的形式保存下来。

MarkDownload 的Google Chrome 扩展可免费下载,Safari 扩展因为开发者认证的原因是收费的 ¥18。

使用中的细节

  • 选中文本后,输入 ‘ 或者[ 这些符号,会自动转成成对的符号并标记选中的内容,而其他markdown的软件则会将符号视为输入替换掉选中文本。
  • ⌘P 打开命令面板,⌘O 快速切换文档面板
  • 「设置- 编辑器」中可「折叠标题」,预览时标题旁会多一个供点击折叠的小三角符号
  • 核心插件-MarkDown 格式转换器可以用来快速转换 Bear 中的高亮语法
  • 「设置 - 文件与链接」中可定义文件删除后是直接进系统回收站还是软件的回收站
  • 在「设置-关于」中更新软件,而不是通过菜单栏来操作
  • 按住 ⌘ 悬停在内链链接上直接预览内容
  • 「设置 - 快速切换」中关闭附件显示,可以净化文件快速浏览列表
  • Mac 端的设置也能自动同步到 iOS 端,包括支持的主题和插件等
  • Obsidian for iOS 中页面中 向下滑动弹出命令窗口,双指从屏幕左侧往右滑就是后退,右侧左滑为前进。

经验分享

单独编辑和打开 md 文件可以搭配Typora 来是使用,Typora 的图片设置中指定一下 Obsidian 的附件文件夹来存储图片,并勾选上「优先使用相对路径」。

Checklist 插件设置,Tag name 为空并只监测 日记 文件夹中的笔记,这样可以省掉输入标签的过程直接输入待办事项。

Obsidian 中 ![[Obsidian 快捷]]会嵌入引用的文档或显示图片,如果写成 [[Obsidian 快捷键]] 就是内部连接(可悬停预览)而不加载这个笔记或图片,区别就是前面是否有 ! 号,非常方便。

利用 Dataview 插件在日记中自动显示过往未完成的待办事项,具体做法是将 Dataview 的代码添加到日记模板当中,然后日记设置中选择这个模板即可。

TASK WHERE !completed


2021-09-09 Dataview 插件更新优化任务检索,语句更简单。
Obsidian 安装第三方的字词统计插件,关闭核心插件中的字数统计。第三方的字词统计可以动态显示选中内容的词数和字符数。

安装 #Obsidian 快捷指令(OB摘录到笔记),实现剪贴板内容快速添加到 Obsidian 当天日记,关联到辅助触控双指触控。PS:编辑「OB摘录到笔记」快捷指令,在插入的文本前添加时间戳。


欢迎大家补充更多自己的经验分享👨🏻‍💻

Comments
Write a Comment
  • 关于剪藏,推荐使用手动大法:打开 Typora(提前设置图片使用相对路径自动复制到obsidian附件目录),使用Typinator之类的扩展工具半自动配置该文档meta信息(可选步骤),然后保存到obsidian文档库根目录,全选网页内容并拷贝,在Typora中粘贴,即可得到包含本地图文的md文件。

  • Max Yang reply

    MacStories前两周的会员通讯写了两期Obsidian的配置和推荐插件,其中Theme推荐的"Minimal" by kepano很不错,专门有插件 Minimal theme settings,用下来挺舒适的,特别是在iOS端。

    • scomper reply

      @Max Yang, 谢谢推荐,安装上 Minimal主题 iPhone 的显示优雅多了。

  • 已折腾上!好用

  • weiwei reply

    请问Mac上的快捷指令是什么APP啊,为什么我的Mac上没有 ,系统版本 macOS Big Sur

    • scomper reply

      @weiwei 升级到 macOS Monterey 才会有。