Obsidian
1 定义
Obsidian 是一款本地优先、基于纯文本 Markdown 格式的知识管理软件,被称为 "第二大脑" 工具,核心定位是帮助用户构建、管理和探索个人知识网络,而非传统的线性笔记应用
2 核心内容
2.1 双向链接
这是 Obsidian 的灵魂。
- 基础链接
- 格式:
[笔记名称](#) - 样例:
[可保权益](#) - 效果:可保权益
- 使用场景:引用或创建一个新笔记
- 格式:
- 别名链接
- 格式:
[显示文本](#) - 样例:
[投保资格](#) - 效果:投保资格
- 使用场景:自定义显示文字,让链接更符合上下文语境
- 格式:
- 标题链接
- 格式:
[标题](#) - 样例:
[第64A条](#) - 效果:保险业条例 > 第64A条
- 使用场景:指向文档内部的具体标题(H1-H6)
- 格式:
- 块引用
- 格式:
[笔记名称^blockid](#) - 样例:
[^68d9e2](#) - 效果:如实告知义务 >
- 使用场景:在某段末尾输入
^+ 自定义名字;只引用某一句话、某一行、某一段。;做文献精读、代码注释、定理引用
- 格式:
书写规则:
^前面必须有一个空格- ID 只能是字母、数字、连字符(-),不能有空格
- ID 在整个知识库的所有笔记文件中必须是唯一的,建议为 ID 添加一个项目前缀来避免冲突,比如你的项目是“AI 伦理”,可以命名为
^aiEthics-quote-01 前面加个!能显示内容
## 原文:
这是一个重要的定义。^important_def
## 引用处:
参见 [^important_def](#)
- 组合链接
- 格式:
[标题|显示文本](#) - 样例:
[第64A条|可保权益延伸](#) - 效果:可保权益延伸
- 使用场景:标题定位 + 别名显示,用于精确引用且自定义显示文字
- 格式:
2.2 反向链接 与 出站链接
- 反向链接:在侧边栏开启,查看“谁引用了当前笔记”。
- 出站链接:查看“当前笔记引用了谁”。
- 价值:无需手动分类,链接自发形成结构。
2.3 属性 YAML
在笔记最上方添加 YAML 格式的数据:
YAML
---
title: 这是一个中文标题
created: 2026-01-16
type: 笔记/项目/资源/永久卡片
tags: [强化学习, 机器人]
status: 待办/进行中/已完成
source: https://arxiv.org/xxx
---
- 用途:为笔记添加元数据,方便后续通过插件进行检索和筛选。
2.4 关系图谱
图谱能让你直观地看到知识点之间的聚类关系。
- 操作:点击左侧边栏的“关系图谱”图标。
- 用途:发现孤立的笔记,或者观察哪些核心概念(节点)连接最广。
2.5 画布
- 功能:一个无限大的白板,可以把笔记、图片、网页拖进去,用连线表示逻辑。
- 场景:进行算法流程设计、论文思路梳理或项目规划。
2.6 插件系统
Obsidian 的强大在于其高度可定制性。
2.7 开发自己的插件
- Obsidian API 文档:https://docs.obsidian.md/Reference/TypeScript+API/
- 示例插件仓库:https://github.com/obsidianmd/obsidian-sample-plugin
- 开发者文档:https://docs.obsidian.md/Plugins/Getting+started/Build+a+plugin
# 克隆官方示例插件
git clone https://github.com/obsidianmd/obsidian-sample-plugin.git my-bulk-linker
cd my-bulk-linker