开始使用Obsidian

有用的链接

Graph View(关系图谱)

关系图谱是Obsidian的特色功能,展示笔记的引用关系,也是一种‘网状的MOC’

Graph view 支持进阶设定,例如展示时排除路径带index的文件夹下的笔记,语法1-path:index
除了上面的path外,还支持 tag、file、path 等变量

备份: [[Obsidian Graph Settings Backup]]

Vault(库)

每个vault下有单独的.obsidian文件夹:

  • .obsidian/thems/: CSS主题目录
  • .obsidian/snippets/: CSS代码片段目录
  • .obsidian/config:
  • .obsidian/workspace:

For example YourOwnVault/.obsidian/.trash is the trash folder,
YourOwnVault/.obsidian/config stores things like your own custom hotkeys,
YourOwnVault/.obsidian/workspace saves things like the most recent files, and the window layout (I think).

App系统文件夹:

  • macOS: ~/Library/Application\ Support/obsidian, 文件缓存在ObsidianCache/IndexedDB/
  • Win: %APPDATA%\Obsidian\

Plugins(插件)

重复打开同一文件的问题:如果在Ob 中已经打开了 fileA,再通过 “快速打开” or “点击双链” 进入 fileA,Ob会重复再开一个标签页:

  • Quicker Switcher++: 替换自带的“快速切换”
  • obsidian-no-dupe-leaves
    解决从双链进入的重复打开;
    • bug:导致 graph view 中的点击行为不正常
  • obsidian-open-in-new-tab:解决从文件管理器的重复打开,作者也提到了是通过hijack文件管理器实现的,所以不能在Quick switcher里工作;

Themes(主题)

主题预览: https://github.com/topics/obsidian-theme

筛选标准:

  • 色彩适中,除代码高亮之外,mkd常用格式(List/Header/Bold/Italic/Quote)颜色不应超过3种;
  • 色彩低饱和
  • 默认字体(加分项)
  • H1-H5大小合适
  • 行间距适中,兼顾效率和可读性
  • List 样试
  • 粗体/斜体 使用高亮颜色

▷在用主题:

▷手机版Obsidian适用的主体:

CSS Snippets

CSS Snippets 可以载入自定义CSS, 自定义 Obsidian 的外观,例如自定 Heading 的显示样式..

设置 => 外观 => CSS 代码片段 管理,

更多可用的 Snippet可以在这里找到: https://github.com/deathau/obsidian-snippets

YAML Front Matter

由于 Markdown 官方标准不支持存储 metadata(例如笔记更新日期、分类等),所以 Obsidian 通过支持 YAML front matter 来解决,目前受 Obsidian 支持的有:

aliases: [别名1, 别名2]
tags:
- 标签1
- 标签2
publish: false

Ob 从v1.4.5之后开始支持文件 properties, 支持的属性有:

  • title: 笔记标题
  • date: 创建日期
  • categories:分类
  • aliases: 别名
  • tags:标签
  • cssclasses: 笔记使用的 CSS Snippets

@ref: https://help.obsidian.md/Editing+and+formatting/Properties

Alias(别名)

在 md文件的 YAML front matter加入:

alias: this's alias example

那么在引用这个文件时,键入[后再输入‘this’s alias example’ 即可,

实际上Ob把 这个语法替换为 [[file-name|alias]],显示为‘alias’而不是文件名。这种格式也被称为 piped wiki-link

Obsidian 支持以下几种link:

  • Link to a file,支持 wiki-link 和 markdown-link:[[]]![]()

  • Link to a heading in a note,[[My note#Heading 1#Heading 2]]

  • Link to a block in a note,Link to a block in a note

  • Change the link display text,[[Internal links|custom display text]]

图片

标准 Markdown 没有提供对图片大小的调整方法,Obs 自带的语法使用类似piped的语法规定图片大小,如下:

![image.png|100](path/image.png)

Callout(标注)

在标准 Markdown GFM 规范中,对于“标注框”都没有明确的定义。因此关于标注框这件事,各家都是采用各自的语法来实现,不同语法之间互不通用。
标注框有点类似 Markdown 中的 > 引言块,但更加醒目。往往用于诸如提示、警告之类的用途,也经常被称为“谏言块”(admonition)。

Obsidian 在引用块上加了一些特殊的语法:

> [!标注类型]
> 这里是标注内容...

支持的“标注类型”有:info、tip、warning、note、todo、question、danger、bug 等,不同的标注类型,渲染出的 icon 和背景色不同:

[!warning]
这是一个警告标注

数学公式

Ob同大部分扩展Markdown一样,也使用 LaTeX 的数学公式语法: $$$

例: 上标、下标、函数

$$\sum_{n=1}^\infty k$$

$\sqrt{3x-1}+\sqrt[5]{2y^5-4}$

$$\cos (2\theta) = \cos^2 \theta - \sin^2 \theta$$

快捷键

Obsidian内建功能快捷键:

  • 快速打开:cmd + O
  • 命令面板:cmd + P
  • 编辑/预览: cmd + E
  • 返回:cmd + alt + ←
  • 访问光标处的链接: alt + Enter
  • 播放关系图谱生长动画: cmd + shift + P
  • 查看关系图谱: cmd + G
  • 查看局部关系图谱: cmd + shift + G

插件快捷键:

  • 插件-Advanced Tables插入表格: 按|,再按Tab
  • 插件-Linter 格式化当前文件: cmd + alt + L
  • 插件-Quick Switcher: cmd + R,再按#进入 Heading 搜索
  • 插件-Templater 插入YAML(自定义):cmd + shift + Y

使用代理(Windows)

快捷方式增加如下参数:
--proxy-server=socks5://127.0.0.1:10808

调试模式

进入调试模式快捷键: option-cmd-i(或 Ctrl+shift+I for Win)

新特性

问题 & Feature Requests

最佳实践

@link:: [[Obsidian最佳实践系列.md]]

Reference