有用的链接
- 特性介绍: Features - Obsidian
- 版本发布: Latest Announcements topics - Obsidian Forum
- Feature requests: Latest Feature requests topics - Obsidian Forum
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(插件)
- Sanqui/obsidian-persistent-graph::保存Graph参数
- DataView : 使用说明 Obsidian插件-Dataview
- obsidian-excalidraw-plugin: 替代自带Graph
- obsidian-reveal-active-file: 打开一个mkd时, 自动在文件树导航到这个文件
- obsidian-switcher-plus: 类似Sublime的Symbol搜索, 自定义快捷键
Cmd
+R
, 呼出搜索框,直接是文件名模糊搜索, 输入@
触发当前文件内搜索Heading, 输入#
触发全库内搜索Heading - obsidian-mind-map: 为当前笔记生成 mind map
- advanced-tables-obsidian: 表格编辑, 输入
|
就可以进入表格编辑, 按Tab
编辑下一个表格的内容 - obsidian-linter: 格式化md文件, 更新yaml头
- OliverBalfour/obsidian-pandoc: 导出为pdf、doc、html等格式
- Obsidian-Html: 将Obsidian笔记导出为网站html, 网站样例: https://obsidian-html.github.io/?path=%2FInstructions%2FUsage.html/
- obsidian-calendar-plugin: 给Obs增加一个日历widget用以显示每天的笔记, 依赖于Obs的Core插件
Daily Note
, 是按照mkd的文件名区分日期的, 对于我来说大部分mkd文件都不是日期命名所以也没多大用处, 希望能改成通过yaml头或者文件modify属性识别日期 - Templater: 更好的模板管理
- easy-typing-obsidian:自动格式化 md
- wikilinks-to-mdlinks-obsidian:一键切换
[[ ]]
和![]()
两种 link 格式 - obsidian-paste-image-rename::Obsidian 的贴图自动命名为“pasted image 日期” 这种带空格的格式,对 URL 显示并不友好,这个插件可以自动按规则重命名图片文件,支持
dirName
、fileName
、date
等变量; - Quiet Outline:更好的显示文件大纲(outline)
- obsidian-custom-attachment-location 自定义粘贴附件的存储位置
- GitHub - esm7/obsidian-map-view: Interactive map view for Obsidian.md 使用 geo locations 生成带标注的地图
- GitHub - iiz00/obsidian-multiple-notes-outline 在文件列表显示笔记的outline
重复打开同一文件的问题:如果在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 样试
- 粗体/斜体 使用高亮颜色
▷在用主题:
GitHub - Carbonateb/obsidian-encore-theme: The Encore theme aims to freshen up the UI of Obsidian.md with modern design, loosely based off Material 3.:如标题描述的,UI元素充满了“modern design”,内置多种配色方案
whyt-byte/Blue-Topaz_Obsidian-css: A blue theme for Obsidian.:很全面的主题,可定制化的细节非常多
kepano/obsidian-minimal: Minimal theme for Obsidian:极简主题,如果不喜欢花里胡哨 —— Minimal,如果为选哪个主题犹豫 —— 那就选 Minimal
mediapathic/obsidian-arsmagna-theme: A theme for Obsidian, inspired by the works of Athanasius Kircher:以卡尔达诺的《Ars Magna》命名的主题,不过已经停更多年
▷手机版Obsidian适用的主体:
- Atom
- Horizon:停更
- Dracula Slim:停更
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] |
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
Files & Links
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$$ |
快捷键
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)
新特性
- Using obsidian URI
- YAML front matter
- Add aliases to note
- Link to blocks
- Link to headings
- Workspace
- 添加自定义CSS
问题 & Feature Requests
在 Graph View使用H1标题替代 filename
Custom Attachment location 相对路径的问题:
- 如果路径设置为
./
开头意为使用相对路径,如果设置为./../_images
插件会抛错 - 并不是插件代码问题,在调用
app.fileManager.generateMarkdownLink
的时候,如果传入的参数是相对路径则抛错,没有继续跟 generateMarkdownLink 的代码
- 如果路径设置为
最佳实践
@link:: [[Obsidian最佳实践系列.md]]