安装与配置
下载安装
官方下载
Obsidian 支持多个平台，可以从官方网站下载：
| 平台 | 系统要求 | 下载方式 |
|---|---|---|
| Windows | Windows 7 及以上 | .exe 安装包 |
| macOS | macOS 10.13 (High Sierra) 及以上 | .dmg 镜像文件 |
| Linux | Ubuntu 18.04 及以上 | AppImage / Snap / Flatpak |
| iOS | iOS 13.0 及以上 | App Store |
| Android | Android 5.0 及以上 | Google Play / APK |
下载地址：https://obsidian.md/download
安装步骤
Windows
- 访问官网下载
.exe安装包 - 双击运行安装程序
- 选择安装路径（建议使用默认路径）
- 选择是否创建桌面快捷方式
- 完成安装后启动 Obsidian
便携版
Windows 用户还可以下载便携版（Portable），无需安装，可直接运行，适合放在 U 盘中使用。
macOS
- 下载
.dmg文件 - 打开 DMG 文件
- 将 Obsidian 图标拖入 Applications 文件夹
- 首次启动时，右键点击应用选择「打开」（绕过安全检查）
- 在弹出的对话框中点击「打开」确认
macOS 安全提示
如果遇到「无法打开，因为它来自身份不明的开发者」，请前往「系统偏好设置 > 安全性与隐私 > 通用」，点击「仍要打开」。
Linux
bash
# 方法一：使用 AppImage（推荐）
# 下载后添加执行权限
chmod +x Obsidian-x.x.x.AppImage
./Obsidian-x.x.x.AppImage
# 方法二：使用 Snap
sudo snap install obsidian --classic
# 方法三：使用 Flatpak
flatpak install flathub md.obsidian.Obsidian
flatpak run md.obsidian.Obsidian
# 方法四：使用 AUR（Arch Linux）
yay -S obsidianiOS
- 打开 App Store
- 搜索「Obsidian」
- 点击「获取」下载安装
- 安装完成后点击「打开」
Android
- Google Play：搜索「Obsidian」下载安装
- APK 下载：访问官网下载 APK 文件直接安装
- F-Droid：通过 F-Droid 商店安装
移动端特殊说明
移动版 Obsidian 的数据存储位置：
| 平台 | 默认存储位置 |
|---|---|
| iOS | iCloud / 本地 / 其他云服务 |
| Android | 本地存储 / SD 卡 |
移动端同步
推荐使用以下方式在移动端访问笔记：
- iCloud（iOS + macOS）
- Syncthing（跨平台免费方案）
- Remotely Save 插件（支持 S3、WebDAV 等）
- Obsidian Sync（官方付费服务）
初始配置
创建仓库
首次启动 Obsidian 时，需要创建或打开一个仓库（Vault）：
- 点击「创建新仓库」
- 选择存储位置（本地文件夹或云同步文件夹）
- 输入仓库名称
- 点击「创建」完成
仓库位置建议
- 避免使用系统目录（如 Program Files）
- 避免使用含有特殊字符的路径
- 建议使用云同步文件夹实现跨设备同步
快速设置向导
创建仓库后，Obsidian 会显示快速设置向导：
yaml
设置选项:
外观: 选择深色或浅色主题
布局: 选择默认编辑模式（阅读/编辑）
同步: 可选择开启 Obsidian Sync 试用
帮助: 是否显示帮助笔记核心设置详解
外观设置
进入「设置 > 外观」：
| 设置项 | 说明 | 建议值 |
|---|---|---|
| 基础主题 | 深色/浅色模式 | 根据偏好选择 |
| 主题 | 社区主题 | Minimal、Blue Topaz 等 |
| 字体大小 | 编辑器字体大小 | 14-16px |
| 界面缩放 | 整体界面缩放 | 100%（高分辨率可调大） |
| 界面字体 | 自定义界面字体 | 使用系统默认或自定义 |
| 文本字体 | 编辑器字体 | 等宽字体如 JetBrains Mono |
编辑器设置
进入「设置 > 编辑器」：
| 设置项 | 说明 | 建议 |
|---|---|---|
| 拼写检查 | 拼写检查 | 中文用户可关闭 |
| 自动配对 | 自动补全括号 | 开启 |
| 智能缩进 | 自动缩进 | 开启 |
| 折叠标题 | 折叠笔记标题 | 开启 |
| 折叠缩进 | 折叠缩进内容 | 开启 |
| 显示行号 | 显示行号 | 按需开启 |
| 阅读视图换行 | 阅读模式自动换行 | 开启 |
| 必须使用 Ctrl+点击 | 链接打开方式 | 按需设置 |
文件设置
进入「设置 > 文件」：
| 设置项 | 说明 | 建议 |
|---|---|---|
| 自动保存 | 自动保存间隔 | 立即保存 |
| 删除确认 | 删除文件确认 | 开启 |
| 回收站位置 | 删除文件存放位置 | 仓库内 .trash 或系统回收站 |
| 默认存放位置 | 新笔记位置 | 指定文件夹 |
| 附件默认存放位置 | 附件位置 | attachments 文件夹 |
| 新建笔记存放位置 | 新笔记位置 | 指定文件夹或当前文件夹 |
目录结构
一个典型的 Obsidian 仓库结构如下：
my-vault/
├── .obsidian/ # Obsidian 配置目录（隐藏）
│ ├── app.json # 应用设置
│ ├── appearance.json # 外观设置
│ ├── core-plugins.json # 核心插件配置
│ ├── community-plugins.json # 社区插件列表
│ ├── themes/ # 主题文件
│ └── plugins/ # 插件文件
├── .trash/ # 回收站（如设置为仓库内）
├── attachments/ # 附件目录
│ ├── images/ # 图片
│ ├── files/ # 其他文件
│ └── audio/ # 音频
├── templates/ # 模板目录
├── daily notes/ # 日记目录
├── projects/ # 项目笔记
├── references/ # 参考资料
└── index.md # 索引笔记（可选）目录组织建议
按主题分类
vault/
├── 工作/
│ ├── 项目/
│ └── 会议/
├── 学习/
│ ├── 读书笔记/
│ └── 课程笔记/
├── 生活/
│ ├── 日记/
│ └── 计划/
└── 参考资料/PARA 方法
vault/
├── Projects/ # 正在进行的项目
├── Areas/ # 责任领域
├── Resources/ # 参考资料
└── Archives/ # 归档内容常见问题
安装问题
Windows 安装失败
问题：提示「安装程序无法创建目录」
解决方案：
- 以管理员身份运行安装程序
- 检查杀毒软件是否拦截
- 更换安装路径（避免中文路径）
macOS 提示已损坏
问题：提示「Obsidian 已损坏，无法打开」
解决方案：
bash
# 在终端执行以下命令
sudo xattr -rd com.apple.quarantine /Applications/Obsidian.appLinux AppImage 无法运行
问题：AppImage 提示权限不足或缺少依赖
解决方案：
bash
# 添加执行权限
chmod +x Obsidian-*.AppImage
# 安装依赖（Ubuntu/Debian）
sudo apt install libfuse2
# 如果仍然无法运行，尝试 Snap 或 Flatpak 版本配置问题
如何迁移仓库？
- 将整个仓库文件夹复制到新位置
- 在 Obsidian 中选择「打开仓库」
- 选择新位置的文件夹即可
注意：.obsidian 文件夹包含所有配置，务必一起复制。
如何重置设置？
删除仓库中的 .obsidian 文件夹，重启 Obsidian 会重新生成默认配置。
警告：这将删除所有设置、主题和插件配置。
如何在不同电脑间同步？
推荐方案：
- Obsidian Sync（官方付费服务，最稳定）
- iCloud（仅限 Apple 生态）
- Syncthing（免费开源，跨平台）
- Git（适合技术用户）
- 网盘同步（OneDrive、Dropbox 等，注意冲突）
不推荐：直接使用云盘可能会产生同步冲突，建议使用专门工具。
核心插件配置
创建仓库后，建议先启用以下核心插件：
进入「设置 > 核心插件」：
| 插件 | 功能 | 推荐开启 |
|---|---|---|
| 日记 | 创建每日笔记 | ✅ |
| 模板 | 使用笔记模板 | ✅ |
| 大纲 | 显示文档大纲 | ✅ |
| 字数统计 | 统计字数 | ✅ |
| 搜索 | 全局搜索 | ✅（默认开启） |
| 图谱 | 知识图谱 | ✅（默认开启） |
| 页面预览 | 悬停预览链接 | ✅（默认开启） |
| 星标 | 收藏常用笔记 | 按需 |
| 反向链接 | 显示反向链接 | ✅（默认开启） |
| 关系图谱 | 笔记关系图 | 按需 |
| 出链 | 显示出站链接 | 按需 |
| 同步 | Obsidian Sync | 按需 |
| 发布 | Obsidian Publish | 按需 |