如何快速入门笔记软件『Obsidian』

news2024/12/23 9:38:30

前言

Obsidian 是基于 Markdown 语法的笔记软件，界面简洁，使用简单，功能实用，支持跨平台数据同步，实现基于双向链接的知识图谱，同时提供各种各样的扩展主题和插件

本文将会详细讲解笔记软件 Obsidian 的安装，配置及基础使用，以及进阶功能和奇技淫巧

官方文档：由此开始 - Obsidian 中文帮助 - Obsidian Publish

安装

官网首页：Obsidian - Sharpen your thinking

然后我们点击首页上方 Download ，然后下载我们对应的版本，安装好之后如下

之后我们就可以创建仓库，然后我们可以点击上面的按钮新建笔记或是文件夹

除此之外，命令面板包含了大多数日常需要的命令，按 Ctrl/Cmd-P 就可以打开

插件

官方文档：如何安装obsdiain插件 - Obsidian中文教程 - Obsidian Publish

我们点击界面左下角的设置按钮，关闭安全模式即可自行下载安装社区插件

页面美化

Obsidian 支持使用自定义 CSS 代码段实现页面美化，但是博主目前没有页面美化需求，读者可以按照如下官方教程自行配置

官方 CSS 教程：自定义 CSS - Obsidian 中文帮助 - Obsidian Publish

注：其实对于笔记软件本身，我们应该关注笔记本身，没有必要过多注重是否美观

创建模板

我们在 Obsidian 中可以使用模板简化操作，首先我们需要确保模板功能打开（最新版中已经默认集成模板插件，并且默认开启），然后点击红框内的设置按钮，配置模板文件夹路径，以便软件识别

然后我们创建文件夹，命令为模板，然后创建模板笔记 随笔摘录，然后写入 YAML front matter

---
title: {{title}}
date: {{date}}
---

如果想要时间更具体，可以使用如下格式

---
title: {{title}}
date: {{date}} {{time}}
---

注：模板和笔记名称都是随意起，没有固定格式

还有就是需要给文档属性显示方式改为 ”源码“ 格式，如果是 ”显示“ 选项会出现奇怪的双引号之类的问题，很不方便

然后我们可以如下文档属性格式（这里虽然爆红，但是不影响后续生成模板）

然后在 随笔摘录 文件夹下随意创建文件，然后点击左侧模板，插入我们上面配置的模板即可

但是很多时候内置模板插件不能满足我们的要求，可以使用第三方插件 Templater

插件文档：Introduction - Templater (silentvoid13.github.io)

下面简单使用 Templater 进行配置

因为博主使用的是 vuepress 博客（主题 vdoing），必须按照官方指定 YAML 格式编写，大家可以酌情参考我的配置

<%*
const PREFIX = '/pages/'
// 定义永久链接数据
function getPermalink() {
  return `${PREFIX + (Math.random() + Math.random()).toString (16).slice (2, 8)}/`
}
// 获取当前文件创建时间
let createTime = tp.file.creation_date("YYYY-MM-DD HH:mm:ss")
// 获取标题
let title = tp.file.title
-%>
---
title: <% title %>
date: <% createTime %>
permalink: <% getPermalink() %>
categories:
  - 随笔摘录
tags:
  - 
author: 
  name: ReturnTmp
  link: https://github.com/ReturnTmp
---

双向链接

双向链接是 Obsidian 非常重要的特性

我们使用[[]]以link的形式插入note。这个可以通过[[filename#header]]的方式引用到更细的层级，也可以用[[filename|代替文本]]的方式进行文本替换
![[]]会将插入的note显示在当前页，类似图片。这个等价于![](note名字)
[链接文字](note name)会以链接方式插入note。这个和[[]]不同在于，这种方式不会自动显示note名字，需要在链接文字中填写。

由于我自己写的博客都是独立的，暂时用不到这个功能，所以这里不详细讲解，有兴趣的可以自行翻阅下面的官方文档

官方文档：双向链接 - Obsidian中文教程 - Obsidian Publish

图片上传

博主在自己的 Typora 中已经配置了使用 PicGo 自动上传图片到 GitHub 仓库，下面为迁移配置 obsidian 步骤

如果您之前没有配置过 PicGo，可以参考官方论坛：在Obsidian中使用图床实现“一次上传、多次搬运” - Obsidian 中文论坛

安装插件 Image auto upload plugin （需要提前开启 PicGo）

此时进行复制粘贴就可以自动，对于上传之前的图片，我们可以执行 Ctrl + P，然后搜索 upload all images 执行对应命令即可

换行问题

Typora 中的换行是默认回车输出两个换行符，切换到 Obsidian 我们可能比较不适应，可以对 Obsidian 做出如下配置

注：typora的实时预览是所见即所得的，类似于富文本编辑器的效果；而Obsidian则提供了渲染结果,（阅读模式）和源码编辑（编辑模式）两个独立的显示。所以，正确的方式是，慢慢适应 Obsidian 的方式

我们可以设置的编辑器栏打开严格换行，然后安装 easy typing 插件，最后按照如下配置即可

云端存储

如果您对数据隐私性要求比较高，可以使用网盘存储，诸如坚果云（推荐）、百度网盘、OneDrive

注：对于网盘存储来说，如果遇到错误设置和错误操作，比如把同步方案为增量同步到云端，或者在无网络的情况下在两台电脑分别编辑了文件，都会导致同步时出现文件冲突，不太方便

我自己对于数据隐私性要求不高（当然可以使用私密仓库保证隐私性），并且为了避免上面的问题，所以本次将会使用 Github 作为存储仓库

首先需要创建仓库 obsidian-library

然后移动到你想要同步的 obsidian 仓库根目录，命令行执行如下操作（自行替换仓库链接）

git init
git add .
git commit -m "init"
git remote add origin git@github.com:ReturnTmp/obsidian-library.git
git branch -M main
git push -u origin main