本地化存储 ```txt Obsidian is a powerful and extensible knowledge base that works on top of your local folder of plain text files. 这是 Obsidian 官网对 Obsidian 的核心介绍。翻译过来就是：“Obsidian 是一个强大且扩展性极高的知识库，建立在你本地文件夹中的纯文本文件中。” ``` 针对这句话有几点需要阐明的是： Obsidian 是知识库管理工具：不单单是文字编辑器，和 word，vim，notepad++ 这些有本质上的区别。学习 ob 的目的不仅仅是为了记笔记，而更多的是打造自己的知识体系，Obsidian 提供笔记管理的工具罢了。这些工具包括但不限于：优化输入体验（vim 模式，模板，自动补全，代码高亮，智能列表，折叠缩进，智能粘贴，图片、音频、视频、网页等多媒体插入），笔记关联（双链，标签，块引用，关系图谱），高度开放的插件系统。 Obsidian 极其强大且扩展性极高：这是由很多方面带来的，一方面是 Obsidian 本身有着高度扩展性， 一方面社区开发活跃，再一方面是本地纯文本可以被任意第三方工具操作。 Obsidian 知识库是一个本地的文件夹：Obsidian 不依赖于网络就可以正常运行，所有的数据都保存到本地，数据永远在自己手里。Obsidian 管理的所有数据都存在于一个文件夹中，这个文件夹称之为库 (vault)，包括配置文件和笔记文件。其中配置文件以 .obsidian 存在于库的根目录中，管理着 ob 的主题，样式，插件和一些运行时的数据。这带来了易于迁移和同步的特性。 Obsidian 是基于纯文本构建：这意味着即使脱离 Obsidian 软件，也是肉眼可读的，借助 > [!note] 和那些惯例一样，我们建立 Obsidian 是因为 Erica 找不到任何东西能满足她建立个人知识库的需要。她已经尝试了从 TiddlyWiki 到 The Brain 的各种软件，但是没有一种感觉是好用的。疫情隔离终于给了我们开始制作的机会。经过更多的思考，我们决定了 obsidian 的三个最基本的方向: > Local-first and plain text 本地优先和纯文本; >Link as first-class citizen 链接作为第一类公民; > Make it super extensible. 使它具有超强的扩展性. 虽然我们称之为个人知识库或者你的“第二大脑”，但是我们也喜欢把它看作是你笔记的 IDE。你可以把 IDE 想象成一个强大的前端，它试图理解你的代码，比如函数和变量存储在哪里，它们的类型是什么，这样做可以使你在输入代码时非常容易地浏览代码和获取建议。 Obsidian 的优势 由于 Obsidian 是基于 Markdwon 纯文本的，一切都尊重纯文本来构建的，最大的好处是脱离 Obsidian 也可读。这就导致有上手难度，但对于大多数人来说，几乎很快就能适应，操作习惯可以通过社区插件弥补。主要难点就只有 Markdown 语法，这种语法格式在知乎，简书，Github 等各大平台都支持，是一种非常优雅的写作方案。 Obsidian 的优点集中在： 高度自定义：每个人不仅可以定制独特的外观，还可以自动化自己的工作流。无代码能力的可以享受社区带来的种种惊喜。正是因为每个人做知识管理的目的和习惯都不同，高度自定义才能满足绝大部分人的需要。可以参看 Obsidian优秀外观分享 高度自动化：一切繁琐重复的操作都能自动化，当然，对于大多数人来说还是得基于插件。 可迁移性极强：本地 Markdown 可以无压力简单导入大部分笔记软件，而其它富文本则可能在此基础上需要做许多的迁移开发工作 强大的社区生态：目前社区里有近 1000 个各式各样的插件，论坛有超过 2 万个帖子 (除去 bug 反馈)，知乎，B 站等地分布着各式各样的教程和分享，仅 Discord 就有接近 10 万人 。 Obsidian 的使用 对于 Obsidian 新手用户，请先参看 Obsidian新手指南。 目录概述 Obsidian 的使用需要清楚 三个目录： 软件安装目录：从官网下载安装后自动创建的 ，C:\Users\<用户名>\AppData\Local\Obsidian ，这个目录是软件运行的必须文件，最好不要做任何修改。 软件缓存目录：同样是安装后自动创建的，Windows 电脑在 C:\Users\<用户名>\AppData\Roaming\obsidian，这个目录保存着软件索引缓存，全部库的地址缓存，快照，沙盒库等，最好不要做任何修改。 库目录：这在打开 Obsidian 时，会让你选择一个文件夹，该文件夹将存放所有的个人数据，包括 Obsidian 的配置，插件，主题，笔记等 其中着重注意库目录，这个文件夹包含了你整个个人数据，备份这个文件夹，你将可以在任何能安装 Obsidian 的地方还原包括笔记，插件，主题，快捷键，布局等在内的所有配置。它长这样 Pkmer-Docs ├── .obsidian //obsidian的配置文件夹 ├── 00-关于 ├── 01-社区资源合集 ├── 02-知识管理基础 ├── 03-知识管理工具 ├── 10-Obsidian ├── 20-深入理解知识管理 ├── 30-知识管理应用 ├── 40-开发者指南 ├── 90-其它 ├── Config ├── License ├── README.md ├── Resource └── 主页.md 除了默认的 .obsidian 外，其余的都是你的笔记。这个文件夹各部分如下： .obsidian ├── app.json //整个软件的配置 ├── appearance.json //外观配置 ├── bookmarks.json //bookmarks核心插件的配置 ├── canvas.json //白板canvas的配置 ├── community-plugins.json //社区插件列表 ├── core-plugins-migration.json //核心插件配置 ├── core-plugins.json //核心插件配置 ├── graph.json //图谱配置 ├── hotkeys.json //快捷键配置 ├── plugins //插件目录，所有安装的第三方插件都在这，手动安装的基础 ├── themes //主题目录，所有安装的第三方主题都在这，手动安装的基础 └── workspace.json //工作区配置 这些配置都是自动生成的，无需担心，一般仅在第三方插件或主题出问题时才会有需要操作其中的 plugins 和 themes 文件夹。 ## 开始使用 ### 第一步：下载 ### 第二步：选择仓库的位置 在你第一次打开应用程序时，会要求你选择一个仓库。 简单来说，“Obsidian Vault”（我们称之为仓库）是你在本地文件系统（或者如果你愿意，可以是你的 Dropbox）上的一个文件夹，Obsidian 会将你的笔记收集和存储在其中。你可以将所有的笔记保存在一个仓库中，也可以创建多个不同的仓库，完全取决于你的个人偏好。 你可以通过点击并选择你希望将 Markdown 文件集合保存在其中的文件夹来选择一个仓库。 ### 第三步 - 了解主题和设置 每个人对于浅色和深色主题都有自己的偏好。Obsidian 默认使用深色主题，但如果你更喜欢浅色主题，你可以轻松地进行更改： 前往设置（位于左下角的齿轮图标）。 选择“外观”选项卡。 选择你偏好的基础主题（浅色或深色） 你还可以通过在此设置中点击“主题”->“管理”按钮来探索其他社区主题。 论坛：[Obsidian Forum](https://forum.obsidian.md/) ### Obsidian 的外观 ##### 基本功能 安装了主题，但还是对主题有些不两意，而且自己也没办法完成整个主题的编写，只想对主题的-些代码进行修改如果在主题的css文件直接修改，那么等主题的作者更新维护后，再重新刷新加载主题就会把更改的内容覆盖掉，为了避免这种状况，可以在obsidian文件夹的snippets文件夹(没有可以自己建这个文件来)里行代码文生放在这里，然后再返回软件，刷新和开启. ![Obsidian 的外观--基本功能](https://cdn.pkmer.cn/images/c73a4d92ad41ea0753e1ac36823c53e0_MD5.png!pkmer) 将 CSS 片段放到 Obsidian 库目录下的 **/.obsidian/snippets/** 文件夹下。 - 段落间距调整 by yaozhuwa - 网格背景 by blue-topaz - Yaozhuwa@CSS - 大纲美化 from subframe 7536 https://forum-zh.obsidian.md/t/topic/11219 - 图片居中 from blue-topaz - 代码行号 from blue-topaz - 标题级别指示 from blue-topaz 多标签页：你可以理解成浏览器众多标签页，你可以新建、拖拽、关闭，各自标签页历史的回退和前进； 独立窗口：你可以理解成浏览器分开了不同窗口； 字体、字号：提供界面字体、字号的更改； 快速调整字体大小（Quick font size adjustment）：可通过 Ctrl + 鼠标滚轮或触控板缩放来调整字体大小。 功能区的布局调整：请参考 Obsidian基础操作问题#Ribbon 区域图标调整方法 可调整 Theme 的 Light（明亮模式）或 Dark（暗黑模式）。 请留意并非每个 Theme 都有这 2 个设定，有些只有 Light、有些只有 Dark。 窗口透明化（Translucent window）：开启后界面会半透明化，视觉上界面的亮度下降。 窗口样式都可设定，但是需要你自己慢慢摸索，这里就不对每一个细节进行了解了 #### 主题 #### 自定义 如果你想自定义一些样式，给你自己使用，那么你需要了解 Obsidian的CSS代码片段，这里会告诉你如何开启对应设置。以及一些可以直接使用的优秀范例。 如果你想学习如何自己定义样式，那么你可以参考 Obsidian的CSS代码片段#自定义 CSS 简单上手指南 中的 Obsidian 建议样式指导。当然你可能还需要附带了解下，Obsidian的YAML和Frontmatter。设计极简风 Obsidian 主页 则提供了如何设计简单的主页方式。 #### 面板 ##### 命令面板 ##### 工作区 ##### 窗口 ### 设置 你可以把 Obsidian 的设置（ Settings）看成主要由 2 大部分组成： - Obsidian 自带的设置选项 - 插件选项选项 - 核心插件选项（官方出品并维护） - 社区插件选项（来自开源社区贡献） 自带设置选项 Obsidian 软件的主要设置，可分成 8 个设置模块： Editor（编辑器） Files & Links（档案&连接） Appearance（界面外观） Hotkeys（快捷键） About（关于） Account（帐户） Core plugins（核心插件） Community plugins（第三方插件） #### 编辑器 (Editor) ![Obsidian 设置--编辑器 (Editor)](https://cdn.pkmer.cn/images/e42a944a7083680c4239837926f1d7cf_MD5.png!pkmer) ![Obsidian 设置--编辑器 (Editor)](https://cdn.pkmer.cn/images/acaf5de0f7579d211e9dce9e8c62cb45_MD5.png!pkmer) #### Files & Links (文件&连接) Confirm file deletion：删除档案前，询问是否删除。这个可依据个人喜好设定。 Default location for new notes：新建立的笔记要储存在哪里。 > [!note] 不成熟的建议 > 建议选择「in the folder specified below（下方指定的文件夹）」，这样方便，在后续笔记多的时候，快速去整理。 Use Wikilinks：设定 Obsidian 的连接格式。此项设定属于 Obsidian 专属的格式，若不设定将以传统 Markdown 格式呈现。 ![Obsidian 设置--Files & Links (文件&连接)](https://cdn.pkmer.cn/images/17366436160e81a9996243cdccf49a7a_MD5.png!pkmer) #### Core plugins (官方插件) Obsidian 官方提供的插件服务。以下稍微介绍每个插件的功能。 Tag pane：显示「标签面板」。 标签面板 ![Obsidian 设置--Core plugins (官方插件)](https://cdn.pkmer.cn/images/5942abc424bdeaf08216ec89f79f3d4f_MD5.png!pkmer) Page preview：对着 `[[连接笔记]]` 按下 cmd/ctrl 时，可以用浮动视窗预览该笔记的文字。 Page Preview ![Obsidian 设置--Core plugins (官方插件)](https://cdn.pkmer.cn/images/657150f1cd609052baddea31528e7d5e_MD5.gif!pkmer) Daily notes：可使用「每日笔记」，后续将专文介绍。 Templates：可使用「笔记模板」快速插入内容，后续将专文介绍。 Outline：显示此则笔记的大纲。 Workspaces：可储存目前的面板布局设置，可储存多套不同的界面布局，以适应不同工作使用需求。 ### 第四步 - 设置你的文件夹 你的新仓库可能看起来有些空荡荡的，不要紧，只要你开始记录和书写，很快他会被装满的。在 Obsidian 中，你可以选择创建一些文件结构来组织你的笔记。 你也可以选择完全依赖反向链接或标签，但许多人喜欢有使用文件夹来组织笔记的选项。反向链接、标签列表 ### 第五步：创建新的笔记并开始记录 要创建一个新的笔记： 在你的键盘上按下“Ctrl+N”（Windows）或“Cmd+N”（macOS）。或者，在文件浏览器选项卡的左上角点击“新建笔记”按钮。 在顶部输入你的笔记名称（笔记将以“your-note-name.md”的形式保存在计算机上）。 输入你的笔记内容，如果需要可以添加 Markdown 格式。你可以创建嵌套的项目符号、列表、添加标题、突出显示文本和粗体文本。 ### 第六步：组织你的笔记 你可以在 Obsidian 中拖放笔记，将它们放入你喜欢的文件夹中。单击并按住左侧的笔记标题，然后将其拖动到文件夹中。 Obsidian 中的关键功能 反向链接和双向链接：如何在 Obsidian 中将你的笔记进行链接 反向链接（也称为双向链接）是 Obsidian 的一个关键功能。尽管 Obsidian 非常适合做笔记，但 Obsidian 真正强大之处在于能够将你的笔记进行链接。通过理解不同信息之间的关联，你可以提高记忆能力，并得到更深层次的见解。 如何在 Obsidian 中为现有的笔记添加链接 1. 在你的键盘上按下两次左方括号 `[[` 2. 从下拉菜单中选择你要链接到的笔记。 ![如何使用 Obsidian 笔记：一步一步的指南--Obsidian 中的关键功能](https://cdn.pkmer.cn/images/20230616010627.png!pkmer) ### Obsidian扩展语法 #### 自定义图片大小 ```txt ![AltText|100x100](https://url/to/image.png)，引用网络图片，并做裁剪，指定宽高 ![AltText|100](https://url/to/image.png)，引用网络图片，指定宽度，图片按照宽度缩放 ![[image.png|100x100]]，对本地图片（仓库中）宽度高度都做裁剪 ![[image.png|100]]，对本地图片（仓库中）并指定宽度，图片按照宽度缩放 或者这样表述你更你更理解： ![图片名称|宽度数值](链接地址)，引用网络图片，并做裁剪 ![[图片名|宽度数值]]，对本地图片（仓库中）宽度高度都做裁剪 ``` #### 标签 标签是一个组织大量笔记的好方法，它能让你更容易找到笔记。标签本质上是一个可点击的检索按钮，点击它 Obsidian 就会自动为你搜索包含这个标签的笔记。比如，点击`#标签` 这个标签后，Obsidian 将会显示库中所有包含这个标签的笔记。标签有各种不同的用法，比如标明笔记的来源或是笔记的种类。Zettelkasten 方法的使用者则会将标签作为连接笔记、连接想法的“切入点”。 可使用的字符 标签中不允许使用空格。所以，如果你想区分标签中的词语，你可以使用以下格式： 使用驼峰式大小写: `#TwoWords` 使用下划线： `#two_words` 使用连字符： `#two-words` 总的来说，标签只允许以下符号： _ 下划线和 - 连字符号 用于 标签的使用#嵌套标签 的 / 斜杠 #### 笔记的引用 引用笔记内容到文本 ```txt 笔记内容引用 引用笔记内容到文本 ![[笔记文件名#标题名]] 引用具体笔记某个标题下的全部内容 ![[笔记文件名^文本块]] 引用具体笔记下某个文本块的内容 [[笔记文件名#标题名]] 链接具体笔记某个标题 [[笔记文件名^文本块]] 链接具体笔记某个文本块 [[笔记文件名^文本块|显示别名]] 链接具体笔记某个文本块，并显示别名 ``` #### Emoji 符号 用一对 : 包裹，里面是 **Emoji** 符号的 **语义化文本** 安装# Emoji Shortcodes插件 **示例：** `:smile:` 效果：:smile: 嵌入图片、视频等 1. 直接拖拽，保存到默认存储位置 2. 复制链接 ```txt 在src后面加上http： ``` **注释语法** 除了markdown自身的  **HMTL**  一样 `` Obsidian还有自身： 两个百分号 ```text %%abc%% ``` %%abc%% ## [[Obsidian基本插件管理]] ## [[Obsidian-callout语法|callout语法]]