Obsidian 版本历史与功能解读

本文系统梳理 Obsidian 从 1.0 正式版至今的重要功能引入时序，涵盖桌面端和移动端更新。当前最新公开稳定版为 1.13（2026-07-30），Catalyst 抢先体验已推进至 1.13.5（2026-08-05）。帮助你了解每个版本的核心变化，快速判断是否需要升级。

相关阅读：新特性概览以功能分类介绍；本文以版本时间线组织。

📌 阅读指引：想快速了解 → 看版本时间线总览；准备升级 → 直接跳转版本升级指南；排查问题 → 先查大数据版本判断，再定位对应版本。

版本时间线总览

版本	发布日期	核心主题	变更量	状态
1.13.5	2026-08-05	Catalyst 持续修复与打磨	小	🔶 Catalyst
1.13	2026-07-30	设置搜索面板、图片全屏查看器、安全 URI 弹窗	大	✅ 公开
1.13.1	2026-06-09	设置搜索增强、Mermaid 即时渲染	中	🔶 Catalyst
1.13.0	2026-05-28	设置重构、声明式插件 API、OKLCH 色彩	特大	✅ 公开
1.12	2026-02-27	CLI 命令行、拖拽缩放	大	✅ 公开
1.11	2026-01-12	Keychain 密钥串、UI 优化	中	✅ 公开
1.10	2025-11-11	Bases 增强、公式与函数	中	✅ 公开
1.9	2025-08-18	Bases 正式版、属性规范化	大	✅ 公开
1.8	2025-01-30	内置 AI 功能 🤖	特大	✅ 公开
1.7	2024-10-16	Bases 原型、数据可移植性	中	✅ 公开
1.6	2024-06-07	RTL 多语言支持、脚注增强	大	✅ 公开
1.5	2023-12-26	可视化表格编辑器 📊	大	✅ 公开
1.4	2023-09	Properties 属性系统 🏷️	大	✅ 公开

1.13（2026-07-30） — 设置搜索、图片查看器与移动端增强

1.13 在 1.13.0 设置重构 + 可搜索（Catalyst）基础上，正式推送公开稳定版，并新增若干面向用户的核心能力。

🔍 可搜索设置面板（公开化）

1.13.0 引入的设置全局搜索在公开版中面向所有用户开放：

在设置顶部搜索框输入关键词，即可跨「核心设置」与「核心插件」定位设置项
搜索结果按分组聚合，支持键盘导航（Ctrl/Cmd-F 聚焦、Enter 打开）
插件开发者通过 1.13.0 的声明式 Settings API 注册的设置项也会自动进入搜索范围
旧版 Settings Search 社区插件已弃用

🖼️ 图片全屏查看器

阅读模式与实时预览（Live Preview）中查看图片体验大幅增强：

点击图片可进入全屏查看器，支持缩放、平移与背景切换
Live Preview 下图片支持新的内联交互（悬停工具栏、快速查看大图）
与 1.12 的拖拽缩放互补，形成完整图片处理能力

🔒 安全确认 URI 弹窗

对外部 obsidian:// 等 URI 调用的安全保护正式稳定：

调用外部 URI 前弹出安全确认对话框，明确展示将执行的操作
可勾选「不再询问」将该 URI 加入允许列表
加载网络驱动器 HTML 资源前同样会显示安全警告

⚠️ 影响集成类文档：依赖 obsidian:// 的自动化、快捷指令、第三方工具（如 Advanced URI、命令行调用）首次触发时会弹出确认框，相关教程需补充说明。详见 URI 集成与 URI 速查表。

文件管理器与属性

文件管理器支持将侧边栏文件直接拖拽到其他视图或编辑器
Properties 全局属性视图中 Backspace 可删除选中属性
书签视图新增搜索功能

Sync 改进

Sync 视图上下文菜单显示全部文件操作项
侧边栏新增搜索菜单项
移除状态栏图标旋转动画以减少空闲耗电

移动端（1.13 Mobile）

iOS 共享表单（Share Sheet）：分享菜单新增 Obsidian 入口，可直接将外部内容（文本、图片、链接、文件）发送到指定仓库/文件夹
标签页切换支持拖拽排序
大文件（笔记/PDF）滚动性能优化
移动端设置同样支持全局搜索

📖 深入阅读：PKMer Obsidian Weekly · 新特性概览

1.13.1（2026-06-09） — 设置完善

设置搜索增强

在 1.13.0 设置重构基础上进一步打磨：

搜索自动过滤：在某一设置分组内搜索时，自动过滤该分组下的条目
返回导航焦点：返回上一步时，焦点自动回到之前所在设置项
鼠标后退键：支持鼠标后退按钮在设置历史中导航
排序操作：Alt + ↑ / Alt + ↓ 上下移动列表条目位置
滑块数值标签：滑块控件始终显示当前值标签，不再依赖提示框

其他改进

Mermaid 即时渲染：允许 Mermaid 后无需重新加载即可渲染
命令面板设置页：改用标准设置渲染方式
社区插件列表：布局优化
CodeMirror 升级：编辑器核心升级至最新版
开发者：滑块/颜色控件新增重置按钮、SettingDefinitionGroup 多类名 bug 修复

🔧 原 Settings Search 插件已弃用，因 1.13 自带搜索功能与其重叠，插件作者 javalent 被列入致谢名单。

1.13.0（2026-05-28） — 设置重构与声明式 API

1.13.0 是继 1.8（AI）之后又一个重大架构更新，核心聚焦于开发者体验和系统底层升级。

🪟 重新设计的设置系统

这是面向用户的最大变化：

能力	说明
独立窗口	设置界面在新窗口中打开（可在 `设置 → 界面` 关闭）
全局搜索	按名称或描述搜索设置项，覆盖核心设置和核心插件
键盘导航	方向键移动、`Enter` 打开、`Ctrl/Cmd-F` 聚焦搜索，兼容 Vim 键位
界面重组	多项设置移至新的「界面」页面，多个设置页重新设计
排除故障模式	可在不重新启用全部插件的情况下退出「受限模式」，方便调试

📜 声明式插件 Settings API

面向插件开发者引入全新设置注册方式：

插件通过声明式 API 描述设置结构，自动集成到全局搜索和键盘导航
需要插件作者适配迁移，旧 display() API 仍可用但不享受搜索集成
官方提供完整的迁移指南和文档

🎨 OKLCH 色彩空间迁移

基础色彩系统底层升级：

基础颜色迁移至 OKLCH 色彩空间（感知均匀，色彩一致性更好）

⚠️ 破坏性变更：--callout-color 变量不再接受 RGB 三元组（如 255,0,0），必须使用合法 CSS 颜色值：

css

/* ❌ 旧格式（已失效）*/
--callout-color: 255,0,0;

/* ✅ 新格式 */
--callout-color: #ff0000;
--callout-color: rgb(255,0,0);

主题和 CSS 片段开发者需同步适配

🔄 Sync 增强

侧边栏文件可直接拖拽到其他视图或编辑器
Sync 视图上下文菜单显示所有文件操作项
侧边栏新增搜索菜单项
移除状态栏图标旋转动画（减少空闲耗电）

编辑器与安全

功能	说明
图片键盘操作	Backspace/Delete 删除、Ctrl-C/X 复制/剪切图片，Vim 兼容
URI 确认对话框	外部调用 Obsidian URI 前弹出确认，可选「不再询问」加入允许列表
网络资源警告	加载网络驱动器 HTML 资源前显示安全警告
插件同步提醒	通过 Sync 同步插件时弹出警告对话框
书签搜索	书签视图新增搜索功能
Properties 增强	Backspace 可删除全局属性视图中选中属性

移动端（1.13.0 Mobile）

iOS 分享扩展支持完整网页内容（搭配 Web Clipper 更强大）
移动端键盘问题修复
iOS 截图崩溃修复

📖 深入阅读：PKMer Obsidian Weekly 2026-05-31 解读

1.12（2026-02-27） — CLI 与附件管理

Obsidian CLI 命令行工具

1.12 引入了全新的命令行接口，支持脚本和自动化：

bash

# 打开 Obsidian
obsidian

# 打开指定仓库
obsidian /path/to/vault

# 打开指定文件
obsidian /path/to/vault --file "日记.md"

# 创建日记
obsidian /path/to/vault --daily

# 搜索
obsidian /path/to/vault --search "关键词"

# 帮助
obsidian help

CLI 优势：

脚本化打开仓库和文件
自动化工作流集成
1.12.7 起 CLI 二进制文件内置，终端响应显著加快
支持自动补全（Shell completion）

图片拖拽缩放

Live Preview 下可拖拽图片角落缩放
双击快速重置图片大小
无需离开编辑器即可调整图片尺寸

附件自动清理

删除文件时可选择同时删除关联附件
可通过设置配置此行为
避免 .obsidian/attachments 积累无用文件

其他改进

文件管理器：支持 Ctrl-C / Ctrl-V 复制粘贴文件
Base 视图：新增搜索栏、支持拖拽导入
Canvas：Canvas 文件中的链接可被反向链接和图谱识别
编辑器：复制内容可携带 HTML 格式

📖 深入阅读：Obsidian 新特性概览

1.12 小版本更新（Catalyst → Public）

Obsidian 1.12 自 2026-02-10 起以 Catalyst 抢先体验方式逐版迭代，最终于 2026-02-27 发布公开稳定版（1.12.0），并在后续持续修复改进至 1.12.7。

版本	日期	通道	核心变更
1.12.1	2026-02-10	Catalyst	移动端发布，包含桌面版全部新功能
1.12.2	2026-02-18	Catalyst	CLI `help`/`daily:path` 命令、Bases 拖拽导入、Canvas 反向链接识别、iOS 原生分享菜单与快捷指令
1.12.3	2026-02-23	Catalyst	复制粘贴链接/标注转标准 Markdown 修复、iOS 快捷指令和小组件问题修复、CLI 挂起修复
1.12.4	2026-02-27	Catalyst	Windows CLI 检测修复、外部链接编码反斜杠修正、移动端幻灯片关闭按钮位置修复
1.12.0	2026-02-27	公开稳定版	以上所有累积功能正式推送
1.12.5	2026-03-05	Catalyst	CLI 终端 `id=` 自动补全增强、编辑器行复制/粘贴位置修正、表格无选区复制内容修复
1.12.6	2026-03-18	Catalyst	CLI macOS/Linux 路径检查修复、编辑器图片滚动条修复、双击重置图片尺寸修复
1.12.7	2026-03-23	公开稳定版	🔑 CLI 二进制文件内置（终端响应显著加快）、`id=` 参数自动补全、安装器升级至 Electron v39

通道说明：Catalyst（抢先体验） 为付费订阅者早期测试通道，比公开稳定版早约 1-4 周。标记为 公开稳定版 的版本已向所有用户推送。

1.11（2026-01-12） — 密钥管理

🔑 Keychain 密钥串

1.11 引入集中式密钥管理：

集中管理：API 密钥、密码统一存储在密钥串
加密存储：使用系统原生密钥链加密（macOS Keychain / Windows Credential Manager）
插件共享：多个插件可共享同一密钥（如 OpenAI API Key），一次配置、全局使用
跨设备同步：通过 Obsidian Sync 加密同步凭证

📖 详细教程：Keychain 功能

属性中 Markdown 链接

文本和列表属性现在支持 Markdown 链接，内部链接在文件重命名/移动时自动更新：

yaml

---
related: "[[项目A]]"
references:
  - "[[论文1]]"
  - "[[论文2]]"
---

设置界面优化

各设置模块新增图标，视觉识别更直观
macOS 开关与滑块更贴近系统原生风格
启动默认打开文件设置项增强

其他改进

功能	说明
粘贴 URL 自动链接	选中文本后粘贴 URL → 自动转换为 `[文本](URL)`
插件自动更新检查	每 3 天后台自动检查插件更新
URI `paneType` 参数	可指定在标签页/分屏/弹出窗口打开
文件名安全校验	重命名时检测 `#`、`]` 等非法字符
Cookie 加密	新版安装器启用 Cookie 加密
Inter Variable 字体	替换 Inter 为可变字重版本

1.10（2025-11-11） — Bases 进阶

Bases 重大增强

1.10 为 Bases（数据库）带来多项核心能力：

功能	说明
分组（Group by）	按任意属性对数据分组，入口在排序菜单
表格摘要（Summarize）	右键列 → Summarize，使用内置函数或自定义公式生成统计
列表视图（List view）	新增列表视图，支持多行内容和嵌套属性
地图插件（Maps）	官方开源地图插件，在地图上可视化 Bases 条目
全键盘导航	新增完整快捷键体系（Tab/Enter/Home/End 等）

公式与函数

新增多种计算函数：

函数	用途	示例
`reduce()`	聚合计算	`reduce(values, f, initial)`
`mean()`	平均值	`mean(rating)`
`median()`	中位数	`median(score)`
`stddev()`	标准偏差	`stddev(amount)`
`random()`	随机排序	`random()`
`html()`	渲染自定义 HTML	`html(template)`

其他改进

带修饰键点击 Ribbon 图标：在新标签页/分屏/新窗口打开
列表属性允许重复值
全局属性视图可右键删除属性（从所有笔记中移除）
YouTube 嵌入修复（Error 153）
阅读模式未选中文本时 Ctrl-C 复制整篇笔记源内容

📖 深入阅读：Bases 数据库

1.9（2025-08-18） — Bases 正式版

🗃️ Bases 核心插件

Bases 正式成为核心插件：

将任意一组笔记转化为功能强大的数据库
支持自定义视图、按属性筛选
创建公式生成动态属性
引入 .base 文件格式
所有数据由本地 Markdown 文件与 YAML 属性支撑

脚注核心插件（Footnotes）

新增侧边栏标签页，在编辑时管理当前文件的所有脚注，无需离开编辑位置。

⚠️ 属性格式规范化（破坏性变更）

废弃旧版属性格式，统一为列表形式：

旧格式（废弃）	新格式（必须）
`tag: 标签名`	`tags: [标签名]`
`alias: 别名`	`aliases: [别名]`
`cssclass: class`	`cssclasses: [class]`

可通过格式转换器核心插件自动修复和迁移。

其他改进

属性编辑器可在页面预览和 Canvas 中使用
Sync 新增「冲突解决」设置（合并 / 创建冲突文件）
页面预览新增「在新标签页中打开」按钮
导出 PDF 流程优化

1.8（2025-01-30） — AI 元年

🤖 内置 AI 功能

1.8 是 Obsidian 历史上功能变更最大的版本之一（98 项新功能），核心亮点是官方内置 AI：

功能	说明
智能补全	编辑时提供 AI 驱动的文本补全建议
文本变换	选中文本后可进行润色、翻译、总结
聊天助手	在侧边栏与 AI 对话，基于笔记内容回答问题
无外部依赖	数据通过 Obsidian 官方服务器中转，不需自行配置 API

📖 深入阅读：AI 专题 · 内置 AI 功能指南

Web Clipper 重大升级

Obsidian 官方浏览器剪藏扩展引入 Schema 模板系统：

自定义提取规则：定义 Schema 精准提取网页数据
一键剪藏：保存网页内容、高亮、标注到 Obsidian
跨浏览器：支持 Chrome、Firefox、Safari、Edge

📖 深入阅读：Web Clipper 使用指南

编辑器与性能

Canvas 嵌入网页：从网页拖拽链接到白板
大量性能优化：大表格和标注块渲染速度提升
文件资源管理器交互增强

1.7（2024-10-16） — 数据基础设施

1.7 着重于底层架构改进和数据可移植性，为后续 1.8+ 重大版本（AI、Bases 正式版）奠定基础：

Bases 原型：数据库功能的早期实验，支持基础筛选和多视图切换，为 1.9 正式版积累经验
属性系统完善：YAML Front Matter 编辑体验改进，新增 List 和 Link 类型支持
数据可移植性增强：所有数据为本地纯 Markdown 文件，无平台锁定风险
Sync 选择性同步：可指定同步特定文件夹，大幅节省移动端存储空间

📖 深入阅读：数据可移植性

1.6（2024-06-07） — 国际化与性能

RTL 多语言支持

全面支持从右到左（RTL）语言（阿拉伯语、希伯来语等）：

界面自动镜像
编辑器按段落自动检测文字方向
混合语言内容无缝编辑

脚注系统增强

[^ 后自动补全
预览模式悬浮脚注
脚注 ID 悬停弹出内容
内联脚注渲染改进

性能大幅提升

启动速度显著加快
大型 Markdown 文件解析速度优化
功能区（Ribbon）可隐藏

其他改进

字数/字符数统计基于当前选区更新
主侧边栏显示当前仓库名称，方便切换
PDF 安全漏洞（CVE-2024-4367）修复

1.5（2023-12-26） — 可视化表格

📊 可视化表格编辑器

1.5 最大的亮点是全新的表格编辑体验：

可视化编辑：直接在表格中编辑单元格，无需手动对齐 Markdown
拖拽调整列宽：拖拽列边界调整宽度
排序与筛选：点击列头排序
新增/删除行列：右键菜单快速操作

这标志着 Advanced Tables 等表格相关插件可以退役。

实时预览增强

Math（LaTeX）公式即时渲染
改进的代码块语法高亮

1.4（2023-09） — Properties 属性系统

🏷️ Properties（属性）

1.4 引入了革命性的 Properties 系统，为笔记添加结构化元数据：

---
title: 笔记标题
tags: [学习, 编程]
created: 2024-01-15
status: 进行中
priority: 5
---

支持的数据类型：Text、Number、Checkbox、Date、Datetime、List、Link、Aliases

📖 深入阅读：Properties 完整指南 · 高级用法

早期版本（1.0 - 1.3）

以下版本缺少年月日精确日期，按大致时间线排列。

版本	发布时间	重要功能
1.3	2023 上半年	多窗口支持、改进的搜索语法、选项卡拖拽
1.2	2022 年末	书签功能、工作区布局保存与恢复
1.1	2022-11	Canvas 白板、标签页系统、主页视图
1.0	2022-10	🎉 正式版发布：Tabs 标签页、核心插件体系确立、Obsidian Publish

版本升级指南

如何升级

桌面端：

打开设置 → 关于
点击「检查更新」
下载并安装

💡 Catalyst 订阅者：可在设置中切换至「抢先体验」通道，比公开版提前获取 1.13.5 等后续修复与新功能。

移动端：App Store / Google Play 搜索 Obsidian 更新

升级注意事项

版本	注意事项
1.13+	✅ 已推送公开稳定版；`--callout-color` CSS 变量格式已变更为 OKLCH/CSS 颜色值，主题与 CSS 片段需适配；外部 URI 调用会弹出安全确认对话框
1.12.7+	CLI 功能需最新安装器（内置专用二进制文件）
1.11+	如使用 Web viewer 插件，请更新安装器
1.9+	属性格式变更（列表形式），建议先运行格式转换器

大数据版本判断

如果你不清楚当前使用的功能对应哪个版本，可以按以下规律判断：

有 新窗口设置面板 + 全局搜索 → 至少 1.13.0+（公开版自 1.13 起全员可用）
有 图片全屏查看器 → 至少 1.13+
有 iOS 共享表单入口 → 至少 1.13（移动端）
有 OKLCH 色彩变量 → 至少 1.13.0+
有 CLI 命令行 → 至少 1.12+
有 Keychain → 至少 1.11+
有 Bases 核心插件 → 至少 1.9+（正式版）
有 内置 AI → 至少 1.8+
有 脚注悬浮预览 → 至少 1.6+
有 可视化表格编辑器 → 至少 1.5+
有 Properties 面板 → 至少 1.4+

Obsidian 版本历史与功能解读 ​

版本时间线总览 ​

1.13（2026-07-30） — 设置搜索、图片查看器与移动端增强 ​

🔍 可搜索设置面板（公开化） ​

🖼️ 图片全屏查看器 ​

🔒 安全确认 URI 弹窗 ​

文件管理器与属性 ​

Sync 改进 ​

移动端（1.13 Mobile） ​

1.13.1（2026-06-09） — 设置完善 ​

设置搜索增强 ​

其他改进 ​

1.13.0（2026-05-28） — 设置重构与声明式 API ​

🪟 重新设计的设置系统 ​

📜 声明式插件 Settings API ​

🎨 OKLCH 色彩空间迁移 ​

🔄 Sync 增强 ​

编辑器与安全 ​

移动端（1.13.0 Mobile） ​

1.12（2026-02-27） — CLI 与附件管理 ​

Obsidian CLI 命令行工具 ​

图片拖拽缩放 ​

附件自动清理 ​

其他改进 ​

1.12 小版本更新（Catalyst → Public） ​

1.11（2026-01-12） — 密钥管理 ​

🔑 Keychain 密钥串 ​

属性中 Markdown 链接 ​

设置界面优化 ​

其他改进 ​

1.10（2025-11-11） — Bases 进阶 ​

Bases 重大增强 ​

公式与函数 ​

其他改进 ​

1.9（2025-08-18） — Bases 正式版 ​

🗃️ Bases 核心插件 ​

脚注核心插件（Footnotes） ​

⚠️ 属性格式规范化（破坏性变更） ​

其他改进 ​

1.8（2025-01-30） — AI 元年 ​

🤖 内置 AI 功能 ​

Web Clipper 重大升级 ​

编辑器与性能 ​

1.7（2024-10-16） — 数据基础设施 ​

1.6（2024-06-07） — 国际化与性能 ​

RTL 多语言支持 ​

脚注系统增强 ​

性能大幅提升 ​

其他改进 ​

1.5（2023-12-26） — 可视化表格 ​

📊 可视化表格编辑器 ​

实时预览增强 ​

1.4（2023-09） — Properties 属性系统 ​

🏷️ Properties（属性） ​

早期版本（1.0 - 1.3） ​

版本升级指南 ​

如何升级 ​

升级注意事项 ​

大数据版本判断 ​

参考资料 ​

相关文章

Obsidian 版本历史与功能解读

版本时间线总览

1.13（2026-07-30） — 设置搜索、图片查看器与移动端增强

🔍 可搜索设置面板（公开化）

🖼️ 图片全屏查看器

🔒 安全确认 URI 弹窗

文件管理器与属性

Sync 改进

移动端（1.13 Mobile）

1.13.1（2026-06-09） — 设置完善

设置搜索增强

其他改进

1.13.0（2026-05-28） — 设置重构与声明式 API

🪟 重新设计的设置系统

📜 声明式插件 Settings API

🎨 OKLCH 色彩空间迁移

🔄 Sync 增强

编辑器与安全

移动端（1.13.0 Mobile）

1.12（2026-02-27） — CLI 与附件管理

Obsidian CLI 命令行工具

图片拖拽缩放

附件自动清理

其他改进

1.12 小版本更新（Catalyst → Public）

1.11（2026-01-12） — 密钥管理

🔑 Keychain 密钥串

属性中 Markdown 链接

设置界面优化

其他改进

1.10（2025-11-11） — Bases 进阶

Bases 重大增强

公式与函数

其他改进

1.9（2025-08-18） — Bases 正式版

🗃️ Bases 核心插件

脚注核心插件（Footnotes）

⚠️ 属性格式规范化（破坏性变更）

其他改进

1.8（2025-01-30） — AI 元年

🤖 内置 AI 功能

Web Clipper 重大升级

编辑器与性能

1.7（2024-10-16） — 数据基础设施

1.6（2024-06-07） — 国际化与性能

RTL 多语言支持

脚注系统增强

性能大幅提升

其他改进

1.5（2023-12-26） — 可视化表格

📊 可视化表格编辑器

实时预览增强

1.4（2023-09） — Properties 属性系统

🏷️ Properties（属性）

早期版本（1.0 - 1.3）

版本升级指南

如何升级

升级注意事项

大数据版本判断

参考资料