迈向Obsidian的第一步

关键字

• Obsidian基础设置
• Obsidian主题
• Obsidian插件

声明

• 本文默认读者已掌握Markdown语法，但通篇并不含有Markdown相关知识。本文立足非常明确，为Obsidian入门者提供少许参照。需要学习Markdown语法的读者可点击此链接自行学习。需要强调的是，习得技术的最佳途径在于实践。Markdown学习门槛超低，更是可以边学边用，极易上手。

• 入门Obsidian最便捷的方法是阅读客户端中自带的简体中文帮助文档，而界面语言又与帮助文档直接对应。调整“简体中文”界面的操作为：

  Settings → About → Language → 简体中文 → Relaunch → 重启后生效

  更加具体的过程，请参考本文“如何将Obsidian的UI调整为中文？”章节中的演示动画。

• 文中提及PARA和MOC两种文档分类方法，能够有效提升管理文档的效率，为突出主旨不会展开说明。详细信息请参考文中注释中的“关于PARA和MOC文档分类技术的说明”环节。

• 为了方便不能访问国际化网络的朋友能够安装Obsidian主题和插件，我特意打包了一份自己在用的主题和插件上传了蓝奏云网盘。由于只要使用Windows 10 x64的体验，无法保证其他操作系统有效性，敬请谅解！安装主题和插件的方法，请参考后文。

Obsidian是什么？

Obsidian首先是免费的Markdown写作工具，能够在其中编辑文案内容，也可预览排版效果。但如果只以写作软件而言，事实上，Obsidian远不如Typora优雅简洁^[1]，也远不如Notion性感活力^[2]。尽管如此，我仍对Obsidian更为青睐。

原因在于Obsidian能够有效解决了三个问题：

1. 有效组织文档（核心需求）：码字撰文绝非一篇一目，严谨之人自然会广建门类，文章篇目倚照此类别分而藏之。但时间久远，文章之间即使联系紧密也会慢慢淡忘，劳形于案牍整理之中难免索然乏味。如能善用PARA和MOC文档分类技术^[3]，关系图谱就能将各篇目文章之间得反向链接和标签网罗其中，联系和关节也就一目了然。
2. 补强能力：尽管Obsidian作者十分勤奋，倾听社区呼声产品也是快速发展。但Obsidian作为两人公司来说不可能思虑如尘，因而公开了一组API供社区爱好者开发插件补强欠缺。
3. 经济性（重要因素）：无可否认，反向链接和卡片式写作的指标性产品是Roam Research，但其300美元的年费也确实吓退了如我一般的“低收入”群体。对比而言，Obsidian对所有人免费且公开，且能够实现Roam Research中的绝大多数功能。

从何处下载Obsidian？

Obsidian公开免费，所以最好从Obsidian官方网站下载。网站会提示用户使用的操作系统，并据此提供安装程序。当然，如有需要也可以找到Windows、Mac和Linux^[4]系统的安装程序。

怎么没有Android和iOS移动端安装程序？是的，这确实是Obsidian中缺失的一环。不过，既然Obsidian是基于Electron开发，制作移动端难度应该不大。迟迟没有发布移动端，恐怕更多是因为移动端有不同于PC的操作特性，甚至iPad和iOS手机的使用方式也有不同。

Obsidian中的文档库（Vault）

第一次运行Obsidian，会被要求指定文档库（Vault）的位置。至少是我自己，在面对这个请求时，诞生了“库为何物”的疑问。所以，不明所以之下也就胡乱指定了D:\工作\个人\码字\myNotes，并沿用至今。

尽管理解得可能不够深刻，依我陋见而言，库在Obsidian中的作用其实就是存储文档的“仓库”。但是，Obsidian有趣的地方在于有些配置是也被存储在了文档库中，所以每一个文档库都可以设置不同的效果。根据我不完整的测试，每个文档库都可以独立设置：

• 与外观有关的一些设置，所以每个文档库的颜值都可以有所不同。
• 下载后的主题（Themes），可以改变配色和视觉效果。
• 安装后的插件（Plugins），可以补强Obsidian的功能。

对于主题和插件更进一步的说明，请下翻查看本文相应章节。

如何将Obsidian的UI调整为中文？

如“声明”中所述，Obsidian默认是以英文界面示人的。设置界面语言为“简体中文”，需要依照以下过程进行操作：
Settings → About → Language → 简体中文 → Relaunch → 重启后生效

调整过程的演示动画如下：

调整Obsidian界面的显示语言

Obsidian设置中的少许说明

Obsidian有很多细节可以把玩。当然，具体选择，需要依据使用者自己的操作习惯而定。

例如：由于惯用Typora和VSCode，我习惯于文档以单窗口编辑状态加以呈现，字号也会被调整得稍微一些便于识别。需要预览排版效果时，会使用热键Ctrl+E加以调整。自动补全Markdown、显示行号、折叠标题和黑暗风格也是必不可少。

无可否认，也会有人喜欢双窗口分别呈现编辑和预览状态来编辑文档，并且把Obsidian设置为半透明效果增强美感。反过来，我却认为半透明效果会降低写作时的专注程度，直接无视。

在后面的章节中，我会提到使用坚果云同步网盘同步文档，而大多数配置也会萧规曹随。

Obsidian中的主题和插件

主题和插件的概念并不少见，例如常用的Chrome和Firefox浏览器就有大量主题和插件可以使用。通常来说，主题会调整原软件配色，有些则能重构布局和结构。而插件会提供额外的功能或改进原软件的不足之处。

Obsidian中主题和插件的分界也是大致如此，但也有特例：有的插件仅仅添加了一些视觉效果，而有的主题则“附带”了一些功能效果。这些特例虽然不多，但确实有用户会在主题中添加js代码增补特定效果。

如何开启选项使用Obsidian社区主题和插件？

在安装Obsidian之后，内置的主题已支持黑暗和明亮两种风格。同时，开发者也提供了一些有用的扩展插件，但需要使用者手动开启并加以适当配置。由于这些“附赠品”为Obsidian开发者自行设计，所以更为安全稳定。

尽管官方主题也很耐看，但天大地大审美最大，要不然怎么会有这么多的爱好者会在Obsidian社区里发布主题？Obsidian基于网络编程技术开发，安全起见默认只允许使用官方默认主题。发布在Obsidian社区中主题经受了众多网友的检验，否则Obsidian也不能通过客户端直接予以推荐。

以下动画演示了开启Obsidian主题运行权限的过程：

通过“设置”开启主题运行权限

Obsidian提供了很多官方插件，但同样基于安全原因，默认关闭了达人们在社区发布的插件运行权限。

下面的动画演示了开启Obsidian插件运行权限的过程：

通过"设置"开启插件运行权限

总结：出于安全考量Obsidian主题和插件的“运行”权限是默认关闭的，开启的方法如下：

• 开启主题权限：设置 → 外观 → 使用自定义主题
• 开启插件权限：设置 → 第三方插件 → 关闭安全模式 → 点击确定，确认关闭安全模式

如何获取和安装Obsidian主题和扩展插件？

理论上获取和安装Obsidian主题和插件是一件非常简单方便的事情。但由于我国网络存在不够国际化的问题，大多数情况下无法成功访问，这时就需使用更符合我国网络情况的方法。

使用Obsidian客户端直接安装主题和插件是最为便捷的方法。这种方式进行安装，不但能获取创作者提供的描述信息，有些更会有演示动画加以演示，所以也更为推荐。

下面的动画演示了安装Obsidian插件的过程：

通过Obsidian客户端中直接安装插件

安装Obsidian主题的过程为：

通过Obsidian客户端中直接安装主题

从演示动画中可了解，我们完全也可以从GitHub下载 Obsidian主题和插件。具体而言，在GitHub以关键字obsidian theme或obsidian plugin进行搜索，即可查找到相关信息。将主题或插件下载后解压缩，并复制到文档库的特定文件夹。

下图演示了在GitHub中搜索，解压缩复制到文档库特定目录实现安装Obsidian主题的过程：

在GitHub中查找Obsidian主题后下载解压缩到特定目录

下图演示了在GitHub中搜索，解压缩复制到文档库特定目录实现安装Obsidian插件的过程：

在GitHub中查找Obsidian插件后下载解压缩到特定目录

总结：

1. 如果需要使用主题和插件，首先需要开启“运行”权限。方法可参考上一节中的演示或总结。
2. 在Obsidian客户端中直接安装主题和插件时，可能需要具备访问国际化网络的能力。具体操作的方法是：
   • 安装插件：设置 → 第三方插件 → 社区插件 → 浏览 → 查找需要的插件 → 安装 → 已安装插件 → 点选开关使该插件生效
   • 安装主题：设置 → 外观 → 查看社区主题 → 浏览 → 查找喜欢的主题 → 使用 → 自动生效
3. 社区达人们也会在GitHub发布主题 和插件 ，我们可以从该网站下载后解压缩到文档库中对应的主题 和插件目录，即可实现安装。
   • 主题在文档库中的位置：文档库 → .obsidian → themes
   • 插件在文档库中的位置：文档库 → .obsidian → plugins

几款推荐的主题和扩展插件

在经过不算太多的使用过程之后，我认为有两款Obsidian主题十分受用，也推荐给大家：Minimal、Dracula for Obsidian和Comfort Smooth。

• Dracula在不少IDE中都有出现，Dracula for Obsidian无疑是其复刻版本。换句话说，如果比较喜欢高对比度的显示效果以及相对亮色的文字配色，Dracula for Obsidian真的是不二选择。
• 喜欢无印良品风格的童鞋，可能会更加倾向Minimal。配合插件Minimal Theme Settings，可以对其显示效果做更为细致调整。比如，我就把“每行字符数”（Line Width）改为了70，同时将显示字体调整为了Sarasa UI SC。最后不得不说一个怨念：Minimal这款主题尽管十分优雅，但却与下文即将提到的插件Emoji Toolbar不够兼容，预览时Emoji小表情会被拉抻失真，让人哭笑不得……
• 我近来的最爱的主题是在黑暗模式下使用Comfort Smooth，结合插件Adanced Appearance调整字体、字号、每行字数等配置后，效果会更好。

另有几款Obsidian插件也十分好用，分别是：Minimal Theme Settings、Adanced Appearance、Templater、Editor Syntax Highlight、Sliding Panes(Andy's Mode)、Better Word Count、Icons、Emoji Toolbar和Mind Map。

• Minimal Theme Settings专门用于调配主题Minimal，可以更加细致的配置该主题中的字体、字号、每行字符数等细节。
• 每个人都有自己的使用习惯，比如我从不习惯左右分栏编辑和预览，觉得这样会分散注意力，因此总是单一文档编辑状态码字，每行都要大号字体显示60个字符才舒坦。可惜，不是每款主题的作者都能接受这种极简的作风，这时就需要使用Adanced Appearance进行调整字体、字号、色彩、每行字数等基础配置。
• Obsidian内置的模板能够在一定程度上提升写作效率（其实很有限，更多只是一种仪式感），使用Templater后我们可以更一步提升模板的灵活性。如有兴趣，可以参阅鄙文《一文掌握Obsidian模板》。
• 不知出于何种原因，在Obsidian编辑状态书写段间代码时，即使标注了语言的类型，也不能提供高亮显示效果。Editor Syntax Highlight正是在此予以了补强。现在已知的一个bug是在段间代码区域书写Markdown的标题时会有显示问题，但使用Obsidian预览时就一切正常。
• 我的使用习惯是尽可能实现文档区的面积最大化。使用并开启插件Sliding Panes(Andy's Mode)后，文档标题会被移至屏幕左侧角落，水平方向能够显示更多信息。
• Obsidian只能统计文档内的字符统计，插件Better Word Count则可以统计选中文本范围内的字符和词汇数量^[5]。
• 习惯了GitHub、Notion和Typora中的Emoji（小表情）？在设置好热键之后，插件Icons和Emoji Toolbar也可以实现同样的效果。不幸的是，插件Emoji Toolbar竟然与主题Minimal不能兼容，怨念ing……
• 有了插件Mind Map，文档也可以转换为思维导图。但是效率好像不高经常会罢工，也许与我国网络环境不够国际化有关系。

补足无法同步的遗憾

Obsidian宣称重视隐私和系统稳定性，所有的文档和附件（依附于文档中的图片、视频或PDF文档）都会存储在本地电脑中。但是Obsidian却以插件的形式设计了Sync（文档云同步）功能，为此还提供了每月$4的收费服务……只能说Obsidian这小兄弟还算讲究武德，但只有氪金才能享受全套服务……

穷人的孩子早当家，Obsidian虽然无情，但日子总还是要过下去。我的解决方案是使用坚果云同步网盘，当然是免费账户，来实现多台设备之间同步的问题。这种方法还有一个好处，由于Obsidian中的主题、插件甚至一些基本设置，都是以文档库为单位进行存储的。所以，网盘在同步库文件夹的同时，也顺手同步各项设置、主题和插件，实现了无感调度。

如果读者资金充足，且特别重视数据隐私，则建议自行购买、搭建NAS（网络存储服务器）一步到位。

---

注释

---

1. Obsidian对比Typora：Typora的优雅最为直接的体现在于，作者在键入的同时Typora就能动态实时地渲染出排版效果。 当然自动化工具对于精细排版有时仍显不足。这时Typora的灵活性在于键入热键Ctrl+/后，可以进入源代码模式加以修改和调整。Typora作为写作工具还有很多优势和便利性，例如：图片直接拖拽图片就能实现插入，能直接渲染显示数学公式等。但不可否认，Typora只适合创作单篇文章，组织和管理文档则力不从心。Typora官网地址是https://typora.io，是不是设计感十足？ ↩

2. Obsidian对比Notion：Notion也是非常棒的写作平台，其优雅性感不输于Typora。写作时以块（Block）作为基础单元，可以随时任意进行调整和编辑。Notion活力十足，充满创造性，例如：能够实时计算的在线表格堪称Excel，多套文案模板则堪比Evernote，多人协同编辑文案等等。但缺点也十分明显，其Markdown标注不太标准，特别是对于中文写作习惯来说很是蹩脚。此外，虽然Notion也能组织和管理文档，但由于没有引入反向链接，也就无法展现出文档之间的联系和关联。 ↩

3. 关于PARA和MOC文档分类技术的说明：文中了提及PARA和MOC两种文档分类技术，对于我们组织文档好处多多。但作为简要的初级教程，本文无法展开叙述。感兴趣的读者，可以点击此链接在B站观看视频自行学习。 ↩

4. Obsidian提供的Linux安装程序：Linux生态极为复杂，任何应用程序几乎都不可能对Linux生态提供全面而定制化的支持。Obsidian官方针对Linux提供了AppImage和Snap两种格式，而有社区达人在维护Flatpak格式安装程序。诸如deb格式安装程序虽有保存，但版本以明显落后于现有版本且已不再跟进更新。 ↩

5. 插件Better Word Count统计词汇数量：根据我有限的使用经验，插件Better Word Count似乎只能统计英文单词的数量。对于中文使用环境来说，我们可以使用该插件统计选中区域内中英文字符的数量。 ↩