核心设置指南

Obsidian 提供了丰富的设置选项，让你可以根据自己的习惯定制使用体验。本文将系统性地讲解每个设置分类，帮助你打造最适合自己的 Obsidian 环境。

设置入口

打开设置的三种方式：

• 快捷键：Ctrl/Cmd + ,
• 左侧边栏：点击齿轮图标
• 命令面板：搜索「设置」

编辑器设置

编辑器设置影响笔记的编辑体验，是最常调整的配置之一。

基本编辑选项

设置项	默认值	说明
可读行宽	开启	限制编辑区域宽度，提高长文阅读舒适度
严格换行	关闭	开启后需手动换行，关闭则自动折行
显示行号	关闭	在编辑模式下显示行号
显示前排标题	开启	在笔记顶部显示属性/标题区域
可折叠标题	开启	允许通过点击标题左侧箭头折叠内容
可折叠缩进	关闭	允许折叠列表的缩进层级
缩进引导线	关闭	在缩进层级间显示竖线引导

推荐配置

# 推荐的编辑器设置
readable_line_length: true    # 保持行宽限制
strict_line_breaks: false     # 自动折行更友好
show_line_number: false       # 一般笔记不需要行号
fold_heading: true            # 折叠标题很实用
fold_indent: true             # 折叠缩进配合列表
indent_guide: true            # 缩进引导线帮助对齐

拼写检查

• 拼写检查语言：在「编辑器 → 拼写检查语言」中选择
• 中文用户一般无需开启拼写检查
• 英文写作时建议开启，支持多语言同时检查

字体与排版

在「外观」设置中调整：

# 等宽字体（代码块和编辑模式）
monospace_font: "JetBrains Mono"

# 正文字体（阅读模式）
text_font: "系统默认"

提示

如果需要全局更换正文字体，建议使用 Custom Font Size 主题或 CSS 片段。

文件与链接设置

文件和链接设置决定了 Obsidian 如何管理笔记文件和内部链接。

文件管理

设置项	推荐值	说明
默认新建笔记位置	仓库根目录 或指定文件夹	避免笔记散落在根目录
新建笔记存放文件夹	Inbox 或 Sources	配合收集→整理工作流
附件默认存放路径	指定文件夹	统一管理图片等附件
内部链接类型	最短路径	让链接更简洁
使用 Wikilink	开启	使用 [[]] 而非 []() 语法

推荐的附件管理

# 方案一：统一附件文件夹
Vault/
├── Inbox/          # 新建笔记先到这里
├── Notes/          # 整理后的笔记
├── Templates/      # 模板
└── Assets/         # 所有附件集中存放

# 方案二：按笔记文件夹存放
Vault/
├── Projects/
│   ├── 项目A/
│   │   └── assets/  # 项目A的附件
│   └── 项目B/
│       └── assets/  # 项目B的附件
└── Daily/
    └── assets/      # 日记的附件

链接设置详解

Wikilink vs Markdown 链接：

# Wikilink（推荐）
[[笔记名]]
[[笔记名|显示文字]]
[[笔记名#标题]]
[[笔记名#^块ID]]

# Markdown 链接
[显示文字](笔记名.md)

注意

切换链接类型不会自动转换已有链接！建议始终使用 Wikilink。

外观设置

外观设置控制 Obsidian 的视觉风格。

主题选择

1. 打开「设置 → 外观 → 主题」
2. 点击「管理」浏览可用主题
3. 选择并应用主题

热门主题推荐：

主题	特点	适合场景
Minimal	极简、高度可定制	专注写作
Blue Topaz	功能丰富、中文友好	日常使用
Yin and Yang	暗色优雅	夜间使用
Things	灵感来自 Things 3	任务管理

CSS 片段

CSS 片段是轻量级的外观定制方式，无需安装完整主题：

1. 打开「设置 → 外观 → CSS 片段」
2. 点击文件夹图标打开片段目录
3. 将 .css 文件放入该目录
4. 返回设置页面刷新并启用

常用 CSS 片段示例：

/* 调整正文字体大小 */
body {
  --font-text-size: 16px;
}

/* 调整行间距 */
.cm-line {
  line-height: 1.8;
}

/* 高亮当前行 */
.cm-active {
  background-color: rgba(124, 58, 237, 0.05);
}

更多 CSS 定制

详见 CSS 代码片段 和 CSS 片段速查表。

字体设置

设置项	说明
界面字体	侧边栏、设置面板等 UI 元素
正文字体	阅读模式下的笔记正文
等宽字体	代码块、编辑模式

中文用户字体建议

推荐使用「霞鹜文楷」(LXGW WenKai) 作为正文字体，开源免费且阅读体验优秀。

快捷键设置

Obsidian 允许自定义几乎所有操作的快捷键。

常用快捷键参考

操作	默认快捷键	建议自定义
命令面板	Ctrl/Cmd + P	保持默认
快速切换	Ctrl/Cmd + O	保持默认
全局搜索	Ctrl/Cmd + Shift + F	保持默认
新建笔记	Ctrl/Cmd + N	保持默认
切换编辑/阅读	Ctrl/Cmd + E	保持默认
插入链接	Ctrl/Cmd + K	保持默认
返回	Ctrl/Cmd + Alt + ←	保持默认
前进	Ctrl/Cmd + Alt + →	保持默认

自定义快捷键

1. 打开「设置 → 快捷键」
2. 搜索要自定义的命令
3. 点击命令右侧的 × 清除默认值
4. 输入新的快捷键组合

提示

使用「导出快捷键」功能备份你的自定义配置，方便在新设备上恢复。

快捷键冲突处理

如果快捷键与系统或其他应用冲突：

• Obsidian 快捷键优先级低于系统全局快捷键
• 建议避免使用 Ctrl/Cmd + Space 等系统保留组合
• 可以为不同操作分配同一快捷键（上下文不同时）

核心插件设置

核心插件是 Obsidian 内置的功能模块，按需启用即可。

推荐启用清单

插件	用途	推荐程度
文件搜索	快速搜索笔记内容	⭐⭐⭐⭐⭐
快速切换	模糊匹配打开笔记	⭐⭐⭐⭐⭐
图谱视图	可视化笔记关联	⭐⭐⭐⭐
日记	每日记录	⭐⭐⭐⭐
模板	快速插入模板内容	⭐⭐⭐⭐
大纲	展示笔记标题结构	⭐⭐⭐⭐
书签	收藏重要笔记	⭐⭐⭐
字数统计	显示笔记字数	⭐⭐⭐
反向链接	查看引用关系	⭐⭐⭐⭐⭐
出链	查看笔记的外部链接	⭐⭐⭐⭐
页面预览	悬停预览链接内容	⭐⭐⭐⭐⭐
搜索	全库搜索	⭐⭐⭐⭐⭐
斜杠命令	输入 / 触发命令	⭐⭐⭐⭐
同步	官方同步服务	付费
发布	官方发布服务	付费

按场景配置

入门用户最少配置：

启用:
  - 文件搜索
  - 快速切换
  - 图谱视图
  - 反向链接
  - 页面预览

日常写作配置：

启用:
  - 文件搜索
  - 快速切换
  - 图谱视图
  - 日记
  - 模板
  - 大纲
  - 反向链接
  - 页面预览
  - 斜杠命令
  - 字数统计

知识管理配置：

启用:
  - 文件搜索
  - 快速切换
  - 图谱视图
  - 日记
  - 模板
  - 大纲
  - 书签
  - 反向链接
  - 出链
  - 页面预览
  - 斜杠命令
  - 字数统计
  - 工作区

第三方插件设置

安全模式

Obsidian 默认开启安全模式，只允许使用核心插件。关闭安全模式后才能使用社区插件。

1. 打开「设置 → 第三方插件」
2. 关闭「安全模式」
3. 点击「浏览」搜索和安装社区插件

插件安装方式

方式一：社区插件市场（推荐）

1. 设置 → 第三方插件 → 浏览
2. 搜索插件名称
3. 点击安装 → 启用

方式二：手动安装（测试版插件）

1. 从 GitHub 下载插件的 Release 文件（main.js、manifest.json、styles.css）
2. 在仓库 .obsidian/plugins/ 下创建插件文件夹
3. 将文件放入该文件夹
4. 重启 Obsidian 并启用插件

方式三：使用 BRAT 插件

BRAT 可以安装 GitHub 上的 Beta 版插件：

1. 先安装 BRAT 插件
2. BRAT 设置 → Add Beta Plugin
3. 输入插件的 GitHub 仓库地址

详见

完整的插件系统介绍请参考 插件系统。

关于设置

「关于」页面包含重要的系统信息：

设置项	说明
当前版本	显示 Obsidian 版本号
检查更新	手动检查新版本
自动更新	开启后自动下载更新
语言	界面语言选择
许可证	个人或商业许可证
仓库信息	当前仓库路径和大小

许可证说明

类型	价格	说明
个人版	免费	个人使用，无功能限制
商业版	付费	商业环境使用
Catalyst	付费	支持开发，获取 Insider 版本

商业使用

如果你在营利性组织中用 Obsidian 工作，需要购买商业许可证。

高级设置

文件恢复

• 自动保存间隔：建议保持默认（5 分钟）
• 快照保留天数：根据仓库大小调整
• 可在「设置 → 文件恢复」中浏览和恢复历史快照

删除文件设置

设置项	选项	推荐
删除文件操作	移至系统回收站 / 移至 .trash / 永久删除	移至 .trash

警告

选择「永久删除」时，删除的文件无法恢复。务必选择移至回收站或 .trash。

设置迁移与备份

导出设置

Obsidian 的设置存储在仓库的 .obsidian/ 文件夹中：

.obsidian/
├── app.json           # 编辑器、文件等设置
├── appearance.json    # 外观设置
├── community-plugins.json  # 已安装的社区插件列表
├── core-plugins.json  # 核心插件启用状态
├── hotkeys.json       # 自定义快捷键
├── graph.json         # 图谱视图设置
└── plugins/           # 各插件配置文件

备份策略

1. Git 版本控制（推荐）：将 .obsidian/ 纳入版本管理
2. 手动备份：定期复制 .obsidian/ 文件夹
3. 云同步：使用 Obsidian Sync 或其他云服务

提示

详见 数据备份策略 了解完整备份方案。

常见问题

问：设置修改后没有生效？

答：部分设置需要重新加载 Obsidian 才能生效。使用 Ctrl/Cmd + R 重新加载。

问：如何重置所有设置？

答：关闭 Obsidian，删除 .obsidian/ 文件夹中的配置文件（保留 plugins/ 和 themes/），重新打开 Obsidian 即可恢复默认设置。

问：设置可以在多个设备间同步吗？

答：使用 Obsidian Sync 或 Git 同步 .obsidian/ 文件夹即可。注意部分设备相关设置（如字体）可能需要分别调整。

问：如何快速找到某个设置项？

答：在设置页面顶部的搜索框中输入关键词，可以快速定位到对应设置。

相关资源

• 安装指南 - 安装与初始配置
• 快捷键速查表 - 完整快捷键参考
• 核心插件配置速查表 - 核心插件配置
• 设置项参考 - 所有设置项一览
• CSS 代码片段 - 外观定制进阶