首页 > 专题 > Obsidian知识库 > 文章详情
返回 Obsidian知识库

2、Obsidian 快速上手 + 最小可用 Wiki 搭建

2026年05月05日 29 阅读 Obsidian知识库

第2篇｜Obsidian 快速上手 + 最小可用 Wiki 搭建

预计完成时间：15分钟
目标：从零开始，让 Obsidian Vault 跑起来

2.1 安装 Obsidian

macOS

# 方法一：Homebrew
brew install --cask obsidian

# 方法二：官网下载
# https://obsidian.md/download

Windows / Linux

官网 https://obsidian.md/download 下载对应版本安装包。

验证安装

安装完成后打开 Obsidian，你应该看到欢迎界面：

┌─────────────────────────────────────────────┐
│  Welcome to Obsidian                        │
│                                             │
│  [Create new vault]   [Open existing vault]│
│                                             │
│  Vault name: _______________                │
│  Choose folder: /Users/you/wiki             │
│                                             │
│            [Create]                         │
└─────────────────────────────────────────────┘

2.2 创建你的第一个 Vault

Vault（保险库）是 Obsidian 的核心概念——就是一个普通的文件夹，但 Obsidian 会把它的 Markdown 文件当作「笔记」来管理。

建议：Vault 和 LLM Wiki 的根目录是同一个目录，这样 Obsidian 直接打开的就是你的 Wiki。

步骤

  1. 点击 Create new vault
  2. Vault name 填：llm-wiki
  3. 点击 Choose folder，选择你希望存放 wiki 的位置（例如 ~/wiki）
  4. 点击 Create

⚠️ 不要勾选「Encrypt vault」和「Use biometric unlock」——我们后续要让 Agent（AI 工具）也能读写这个目录，加密会让它们无法访问。

2.3 最小目录结构

打开 Vault 后，左侧边栏是文件浏览器（默认隐藏，可以按 Cmd/Ctrl + E 切换）。

我们在文件系统层面创建完整的 LLM Wiki 目录结构。Obsidian 本身不需要任何设置——它会自动读取文件夹里的所有 Markdown 文件。

图形化方式创建

在 Obsidian 左侧文件浏览器：

  1. 右键 → 新建文件夹 → 命名为 raw
  2. 右键 raw → 新建子文件夹：articles、papers、transcripts、assets
  3. 右键 → 新建文件夹 → 命名为 entities
  4. 右键 → 新建文件夹 → 命名为 concepts
  5. 右键 → 新建文件夹 → 命名为 comparisons
  6. 右键 → 新建文件夹 → 命名为 queries
  7. 新建文件夹：_archive（归档页存放）
  8. 新建文件夹：_meta（元数据页面）

最终目录结构

llm-wiki/                ← Obsidian Vault 根目录
├── SCHEMA.md           ← Wiki 宪法（后续篇章详解）
├── index.md            ← 知识目录
├── log.md              ← 活动日志
├── raw/
│   ├── articles/        ← 网页文章
│   ├── papers/         ← PDF 论文
│   ├── transcripts/    ← 会议/访谈文字稿
│   └── assets/          ← 图片/图表（用 ![[image.png]] 引用）
├── entities/           ← 实体页（人/公司/产品/模型）
├── concepts/           ← 概念页（技术/方法/理论）
├── comparisons/        ← 对比分析页
├── queries/            ← 有价值的问答结果存档
├── _archive/           ← 已归档页面
└── _meta/              ← 元数据页面（如 topic-map.md）

2.4 核心文件：新建空白模板

Obsidian 创建新笔记的方式：在文件浏览器右键 → 新建笔记，或者用快捷键 Cmd/Ctrl + N。

我们先创建三个骨架文件（暂时留空，第3篇会详细填写内容）：

2.4.1 SCHEMA.md

在根目录新建 SCHEMA.md，内容如下（先留空，后续整篇讲解）：

# Wiki Schema

## Domain
（你的 Wiki 主题领域）

## Conventions
- 文件名：全小写，中划线分隔（如 `transformer-architecture.md`）
- Wiki 页面必须包含 YAML frontmatter
- 使用 `[[wikilinks]]` 进行页面间链接，每个页面至少 2 个出站链接
- 更新页面时更新 `updated` 日期
- 所有操作记录到 `log.md`

## Frontmatter
```yaml
---
title: Page Title
created: YYYY-MM-DD
updated: YYYY-MM-DD
type: entity | concept | comparison | query
tags: [tag1, tag2]
sources: [raw/articles/source-file.md]
---

Tag Taxonomy

（允许使用的标签列表）

Page Thresholds

  • 出现在 2+ 来源的实体 → 创建实体页
  • 深度解释的概念 → 创建概念页
  • 单次提及 → 不建页

Update Policy

（新旧信息冲突时的处理规则）


### 2.4.2 `index.md`

```markdown
# Wiki Index

> 内容目录。每篇 Wiki 页面按类型列出，附一句话摘要。
> 最后更新：YYYY-MM-DD | 总页数：0

## Entities

## Concepts

## Comparisons

## Queries

2.4.3 log.md

# Wiki Log

> 维基所有操作的时序记录。 Append-only。
> 格式：`## [YYYY-MM-DD] action | subject`
> 操作类型：ingest, update, query, lint, create, archive, delete

## [YYYY-MM-DD] create | Wiki initialized
- Domain: （你填的领域）
- Structure: SCHEMA.md, index.md, log.md

2.5 Obsidian 基础设置

按 Cmd/Ctrl + , 打开设置。以下是推荐配置：

2.5.1 必开功能

| 设置项 | 路径 | 建议值 |
|--------|------|--------|
| Wikilinks | Settings → Editor | ✅ 开启（默认开启） |
| Auto pair brackets | Settings → Editor | ✅ 开启 |
| Show line numbers | Settings → Editor | ✅ 开启（方便调试 frontmatter） |

2.5.2 必装插件

Obsidian 默认关闭插件市场，需要先开启：

Settings → Privacy → Safe mode → 关闭 Safe mode

然后安装以下插件：

| 插件名 | 功能 | 安装方式 |
|--------|------|----------|
| Dataview | 类 SQL 查询笔记 | Community plugins → 搜索 Dataview → 安装 |
| Local REST API | 让 Agent 通过 HTTP 读写笔记 | Community plugins → 搜索 → 安装 |
| Templater | 自动化创建带模板的新笔记 | Community plugins → 搜索 → 安装 |

2.5.3 Dataview 设置

安装 Dataview 后无需特殊配置，直接可用。几个常用查询示例（在任意笔记中运行）：

```dataview
TABLE tags, updated
FROM "entities"
WHERE contains(tags, "person")
SORT updated DESC
```

📝 以上代码块在 Obsidian 里会渲染成表格。但注意：Dataview 查询只在 Obsidian 内部渲染，导出为纯 Markdown 时不会显示表格。

2.6 创建第一篇笔记

方式一：Obsidian 图形界面

在文件浏览器右键 → 新建笔记，命名为 attention机制（会自动放到根目录）。

方式二：命令行创建

# 在 wiki 根目录执行
touch ~/wiki/concepts/attention机制.md

打开文件，写入：

---
title: Attention 机制
created: 2026-05-04
updated: 2026-05-04
type: concept
tags: [nlp, architecture, deep-learning]
sources: []
---

# Attention 机制

## 定义

Attention 机制是一种让模型在生成输出时「关注」输入不同部分的技术。最早由 Bahdanau 等人在 2015 年提出，用于改善 RNN 机器翻译的效果。

## 核心思想

不再将整个源序列压缩成固定向量，而是让模型在每一步生成时动态地「看」源序列的不同位置。

## 相关概念

- [[transformer架构]] — Attention 是 Transformer 的核心组件
- [[self-attention]] — 一种特殊的 Attention 形式

注意我们写了 [[transformer架构]] 和 [[self-attention]]——这两个页面目前不存在，Obsidian 会以红色显示（broken link）。这是正常的，等后续建了相关页面再填充。

2.7 验证：Graph View 效果

按 Cmd/Ctrl + G 打开 Graph View（知识图谱）。

如果一切正常，你应该看到：

        [attention机制]
           ↕
      （暂无连接，因为另外两个页面不存在）

第一篇笔记创建成功。

2.8 常见问题

Q1：Obsidian 打开 vault 很慢

可能是因为文件太多。建议在 raw/ 目录放图片不要超过 1000 张，或者把附件路径改为 raw/assets/。

Q2：Wikilinks 不高亮

检查 Settings → Editor → Wikilinks 是否开启。

Q3：Dataview 不渲染

确认 Dataview 插件已启用（不是只安装了），在 Community plugins 列表里看状态是否为绿色。

Q4：Agent 想读写笔记怎么办

安装 Local REST API 插件后，Obsidian 会暴露一个本地 HTTP 接口，Agent 可以用 curl 请求来创建/读取/搜索笔记。

# 示例：创建一篇新笔记
curl -X POST http://localhost:8023/new \
  -H "Content-Type: application/json" \
  -d '{"path": "concepts/test.md", "content": "# Test\n\nHello world"}'

2.9 小结

  • Obsidian 本质是一个本地 Markdown 文件浏览器，Vault 就是文件夹
  • LLM Wiki 的目录结构和 Obsidian 的文件夹完全对应
  • 最小 Wiki = 根目录 + raw/ + entities/ + concepts/ + comparisons/ + queries/ + SCHEMA.md + index.md + log.md
  • 必装插件：Dataview（查询）、Local REST API（Agent 接入）、Templater（模板）
  • Graph View（Cmd/Ctrl+G）可视化展示 wikilinks 关系

下一篇预告：第3篇我们将深入讲解 SCHEMA.md 的完整写法，包括 conventions、frontmatter 规范、Tag Taxonomy 设计，以及 Page Thresholds 的实际决策逻辑。SCHEMA.md 是让 Wiki 不变成「垃圾堆」的关键。

Obsidian