设置项参考
Obsidian 的设置项分布在多个分类中。本文按分类逐一说明每个设置项的作用和推荐值。
编辑器
| 设置项 | 默认值 | 推荐值 | 说明 |
|---|---|---|---|
| 可读行宽 | 开启 | 开启 | 限制编辑器宽度，提高阅读体验 |
| 可读行宽值 | 700 | 700-800 | 可读行宽的像素值 |
| 严格换行 | 关闭 | 按需 | 开启后按 Enter 换行，而非段落 |
| 显示行号 | 关闭 | 按需 | 在编辑模式显示行号 |
| 显示缩进参考线 | 开启 | 开启 | 显示缩进层级辅助线 |
| 使用制表符缩进 | 关闭 | 关闭 | 使用空格代替 Tab 缩进 |
| Tab 大小 | 4 | 2 或 4 | 每次缩进的空格数 |
| 自动转换 HTML | 关闭 | 按需 | 粘贴 HTML 时自动转为 Markdown |
| 自动匹配括号 | 开启 | 开启 | 输入左括号自动补全右括号 |
| 自动关闭 Markdown 语法 | 开启 | 开启 | 输入 * 自动补全 ** |
| 智能拼写检查 | 关闭 | 按需 | 英文拼写检查（对中文无影响） |
| Vim 键绑定 | 关闭 | 按需 | 启用 Vim 编辑模式 |
| 增强排版 | 开启 | 开启 | 改善中文排版（中英文间距等） |
文件与链接
| 设置项 | 默认值 | 推荐值 | 说明 |
|---|---|---|---|
| 检测所有文件扩展名 | 关闭 | 按需 | 在文件树中显示非 .md 文件 |
| 新附件默认位置 | 仓库根目录 | 指定文件夹 | 新图片/附件的保存位置 |
| 内部链接类型 | 最短 | 最短 | [[笔记]] vs [[文件夹/笔记]] |
| 使用 [[Wikilinks]] | 开启 | 开启 | 使用 [[]] 而非 []() 链接语法 |
| 附件文件夹路径 | — | Attachments | 附件保存的文件夹 |
| 删除文件设置 | 移到回收站 | 移到回收站 | 删除笔记的行为 |
外观
| 设置项 | 默认值 | 推荐值 | 说明 |
|---|---|---|---|
| 基础主题 | 深色 | 按喜好 | 深色/浅色主题 |
| 浅色/深色主题 | 默认 | 按喜好 | 可从社区主题中选择 |
| 字体 | — | 按喜好 | 编辑器正文字体 |
| 字体大小 | 16 | 15-18 | 正文字号 |
| 界面字体 | — | 按喜好 | 侧边栏、设置等界面字体 |
| 界面字体大小 | 14 | 13-15 | 界面字号 |
| CSS 代码片段 | — | — | 自定义 CSS 样式 |
快捷键
常用快捷键推荐
| 操作 | 默认 | 建议修改 |
|---|---|---|
| 命令面板 | Ctrl/Cmd + P | 保持默认 |
| 快速切换 | Ctrl/Cmd + O | 保持默认 |
| 全局搜索 | Ctrl/Cmd + Shift + F | 保持默认 |
| 打开日记 | 无 | Ctrl/Cmd + D |
| 插入模板 | 无 | Ctrl/Cmd + T |
| 切换编辑/预览 | Ctrl/Cmd + E | 保持默认 |
| 返回 | Ctrl/Cmd + Alt + ← | 保持默认 |
| 前进 | Ctrl/Cmd + Alt + → | 保持默认 |
核心插件
| 插件 | 默认 | 建议 | 说明 |
|---|---|---|---|
| 文件资源管理器 | 开启 | 开启 | 文件树导航 |
| 搜索 | 开启 | 开启 | 全局搜索 |
| 快速切换 | 开启 | 开启 | Ctrl+O 快速打开文件 |
| 图谱视图 | 开启 | 开启 | 知识图谱 |
| 反向链接 | 开启 | 开启 | 查看被引用关系 |
| 出链 | 开启 | 开启 | 查看当前笔记的链接 |
| 标签面板 | 开启 | 开启 | 标签列表 |
| 页面预览 | 开启 | 开启 | 悬停预览链接内容 |
| 日记 | 关闭 | 开启 | 日记功能 |
| 模板 | 关闭 | 开启 | 基础模板 |
| 书签 | 关闭 | 开启 | 快速收藏 |
| 工作区 | 关闭 | 开启 | 保存窗口布局 |
| 文件恢复 | 关闭 | 开启 | 自动保存版本快照 |
| 同步 | 关闭 | 按需 | 官方同步服务 |
| 发布 | 关闭 | 按需 | 官方发布服务 |
| 录音 | 关闭 | 按需 | 语音录制 |
| 拼写检查 | 关闭 | 按需 | 英文拼写检查 |
| 大纲 | 开启 | 开启 | 标题导航 |
| 字数统计 | 开启 | 开启 | 底部显示字数 |
| 幻灯片 | 关闭 | 按需 | 演示模式 |
搜索
| 设置项 | 默认值 | 推荐值 | 说明 |
|---|---|---|---|
| 搜索大小写敏感 | 关闭 | 关闭 | 默认不区分大小写 |
| 包含 PDF 内容 | 关闭 | 开启 | 同时搜索 PDF 文件内容 |
| 显示上下文 | 开启 | 开启 | 显示匹配行的上下文 |
| 显示附近匹配 | 3 | 3-5 | 上下文行数 |
| 排除文件夹 | — | .obsidian,.trash | 不搜索的目录 |
同步
| 设置项 | 默认值 | 推荐值 | 说明 |
|---|---|---|---|
| 同步仓库 | — | 当前仓库 | 选择要同步的仓库 |
| 同步间隔 | 10 分钟 | 10 分钟 | 自动同步间隔 |
| 仅同步以下文件夹 | 关闭 | 按需 | 限制同步范围 |
| 排除以下文件夹 | — | 按需 | 不同步的文件夹 |
| 版本历史 | 保留 1 年 | 保留 1 年 | 文件版本保留时间 |
| 端到端加密 | 开启 | 开启 | 加密同步数据 |
第三方插件
| 设置项 | 默认值 | 推荐值 | 说明 |
|---|---|---|---|
| 第三方插件 | 关闭 | 开启 | 启用社区插件 |
| 受限模式 | — | 了解后关闭 | 安全提示，限制非审核插件 |
安全提示
第三方插件可以访问你电脑上的所有文件。仅安装你信任的插件，建议只从 Obsidian 官方插件市场安装。
常见问题
设置修改后没有生效？
- 部分设置需要重启 Obsidian
- CSS 代码片段修改后需要重新启用
- 主题更改后需要刷新（
Ctrl+R）
如何重置所有设置？
- 关闭 Obsidian
- 删除
.obsidian/文件夹中的配置文件 - 重启 Obsidian 会生成默认配置
注意
删除 .obsidian/ 会同时删除插件和主题配置，建议先备份。
设置可以导出吗？
- 手动复制
.obsidian/文件夹 - 使用「Settings Export」插件导出配置
- 使用 Git 版本控制追踪配置变更