无障碍与辅助功能

Obsidian 致力于让所有用户都能高效使用。本文介绍 Obsidian 内置的无障碍功能和辅助技术支持。

概述

无障碍设计原则

Obsidian 在以下方面提供无障碍支持：

类别	功能	适用人群
键盘操作	全键盘导航和操作	运动障碍、效率用户
视觉辅助	高对比度、缩放、色盲支持	视觉障碍
屏幕阅读器	ARIA 标签、语义化结构	盲人/低视力用户
输入辅助	语音输入兼容、慢速模式	输入困难用户
认知辅助	简洁界面、专注模式	注意力障碍

键盘导航

全局快捷键

Obsidian 支持完整的键盘操作，无需鼠标即可完成所有核心任务：

文件导航

快捷键	功能
`Ctrl/Cmd + O`	快速打开笔记
`Ctrl/Cmd + P`	命令面板
`Ctrl/Cmd + Shift + F`	全局搜索
`Ctrl/Cmd + E`	切换编辑/预览模式
`Ctrl/Cmd + W`	关闭当前标签页

编辑操作

快捷键	功能
`Ctrl/Cmd + B`	加粗
`Ctrl/Cmd + I`	斜体
`Ctrl/Cmd + K`	插入链接
`Ctrl/Cmd + [`	减少缩进
`Ctrl/Cmd + ]`	增加缩进

面板切换

快捷键	功能
`Ctrl/Cmd + \`	切换侧边栏
`Ctrl/Cmd + 1~8`	切换到第 N 个标签页

自定义快捷键

所有命令都可以自定义快捷键：

打开设置 → 快捷键
搜索目标命令
点击快捷键输入框
按下你想设置的组合键

建议

如果你使用屏幕阅读器，建议将常用操作设置为单键或少量组合键，减少按键次数。

Vim 模式

Obsidian 内置 Vim 键位绑定，适合 Vim 用户：

打开设置 → 编辑器
启用「Vim 键位绑定」
使用 Vim 操作模式编辑笔记

详细的 Vim 操作请参考 Vim 模式。

屏幕阅读器支持

支持的屏幕阅读器

平台	推荐屏幕阅读器	支持程度
Windows	NVDA / JAWS	良好
macOS	VoiceOver	良好
Linux	Orca	基本
iOS	VoiceOver	良好
Android	TalkBack	基本

ARIA 支持

Obsidian 界面元素包含 ARIA（无障碍富互联网应用）标签：

按钮：所有按钮都有描述性标签
菜单：菜单项有角色和状态标注
对话框：模态框有标题和焦点管理
列表：文件列表有结构化标注
编辑器：行号和内容区域有语义标注

屏幕阅读器使用技巧

导航技巧

使用标题导航：H 键（NVDA）在笔记标题间跳转
使用列表导航：I 键在列表项间移动
使用地标导航：D 键在界面区域间切换
命令面板：Ctrl/Cmd + P 是最通用的操作入口

编辑技巧

使用实时预览模式，屏幕阅读器朗读更流畅
用 Markdown 标记代替格式按钮：**粗体**、*斜体*
在设置中关闭「行号」减少干扰信息
使用模板减少手动输入

已知限制

图谱视图对屏幕阅读器不友好，建议使用反向链接面板替代
Canvas 白板的键盘操作支持有限
部分社区插件的无障碍支持参差不齐

视觉辅助

缩放

Obsidian 支持界面缩放：

操作	快捷键
放大	`Ctrl/Cmd + =`
缩小	`Ctrl/Cmd + -`
重置	`Ctrl/Cmd + 0`

也可在设置 → 外观 → 缩放级别中精确设置。

字体调整

在设置 → 外观中调整：

设置	说明	推荐
界面字体	整体界面字体	选择清晰的无衬线字体
正文字体	笔记编辑区字体	至少 16px
等宽字体	代码块字体	清晰等宽字体
字体大小	正文字号	16-18px

高对比度模式

使用深色主题

打开设置 → 外观
选择「深色」基础主题
或安装高对比度社区主题

主题	特点
High Contrast	专为视觉障碍设计
Minimal Dark	高对比度深色主题
Dracula	高饱和度配色
Solarized	科学配色方案

自定义 CSS 增强

在 snippets/ 文件夹中创建 accessibility.css：

css

/* 增强对比度 */
body {
  --text-normal: #ffffff;
  --text-muted: #cccccc;
  --background-primary: #000000;
}

/* 增大行间距 */
.cm-line {
  line-height: 1.8;
}

/* 增大段落间距 */
p {
  margin-bottom: 1.2em;
}

/* 高亮当前行 */
.cm-active {
  background-color: rgba(255, 255, 0, 0.15) !important;
}

/* 增强链接可识别性 */
a, .internal-link, .external-link {
  text-decoration: underline !important;
  font-weight: bold;
}

/* 增大光标 */
.cm-cursor {
  border-left-width: 3px !important;
}

/* 增强复选框大小 */
.task-list-item-checkbox {
  width: 18px !important;
  height: 18px !important;
}

在设置 → 外观 → CSS 代码片段中启用。

色盲友好

避免仅靠颜色传达信息

使用图标 + 颜色组合（如 ✅ + 绿色、❌ + 红色）
在表格中使用文字标注而非纯颜色
使用标签状态（如 [已完成]）代替颜色标记

调整配色方案

css

/* 色盲友好配色 */
.cm-positive { color: #2980b9 !important; }  /* 蓝色替代绿色 */
.cm-negative { color: #e67e22 !important; }  /* 橙色替代红色 */

专注与减少干扰

专注模式

减少界面元素，帮助注意力集中：

切换到「专注模式」：隐藏侧边栏和标签页
使用快捷键 Ctrl/Cmd + \ 隐藏侧边栏
使用「打字机滚动」：将当前行居中显示

减少动画

在设置 → 外观中：

关闭「动画过渡效果」
关闭「平滑滚动」

css

/* 禁用所有动画 */
* {
  animation-duration: 0s !important;
  transition-duration: 0s !important;
}

简洁界面

css

/* 隐藏不常用元素 */
.workspace-ribbon { display: none; }         /* 隐藏左侧功能区 */
.nav-header { display: none; }               /* 简化导航栏 */
.status-bar { display: none; }               /* 隐藏状态栏 */

输入辅助

语音输入

Obsidian 兼容系统级语音输入：

macOS：系统偏好设置 → 键盘 → 听写
Windows：设置 → 语音 → 语音输入
移动端：使用系统键盘的语音输入按钮

模板减少输入

使用模板系统减少重复输入：

核心模板插件：简单变量替换
Templater 插件：动态内容生成
QuickAdd 插件：一键添加内容

详见模板系统和 Templater 高级教程。

自动补全

标签补全：输入 # 自动提示已有标签
链接补全：输入 [[ 自动提示笔记名称
命令补全：命令面板中模糊搜索

移动端辅助功能

iOS VoiceOver

支持触摸浏览和手势导航
编辑区域有适当的焦点管理
按钮和控件有 VoiceOver 标签

Android TalkBack

基本的触摸导航支持
编辑器内容可朗读
部分自定义控件需要辅助操作

移动端优化建议

增大字体大小
使用较大的触控目标
减少界面元素密度
使用移动端小组件快速访问

辅助工具推荐

文本转语音

工具	平台	特点
系统朗读	macOS/iOS	内置，免费
自然朗读	Windows	中文支持好
Read Aloud	Chrome 扩展	浏览器中使用

语音转文字

工具	平台	特点
系统听写	macOS/Windows	内置
Whisper	全平台	本地运行，隐私
讯飞语记	全平台	中文识别优秀

辅助插件

插件	功能	适用场景
Hotkeys for specific files	为特定文件设置快捷键	减少导航步骤
QuickAdd	一键操作	减少复杂交互
Commander	自定义命令按钮	添加可视化操作入口
Editing Toolbar	可视化编辑工具栏	替代键盘格式化

反馈与改进

报告无障碍问题

如果你发现无障碍相关问题：

在 Obsidian 官方论坛发帖
在 GitHub Issues 提交
标注「accessibility」标签

参与改进

翻译无障碍相关文档
测试并反馈屏幕阅读器兼容性
开发无障碍友好的社区插件和主题
分享你的无障碍使用经验

常见问题

Obsidian 对屏幕阅读器支持好吗？

Obsidian 的核心功能对屏幕阅读器有良好支持，包括文件导航、编辑、搜索等。部分高级功能（如图谱视图、Canvas）的无障碍支持仍在改进中。

可以完全不用鼠标操作 Obsidian 吗？

可以。通过命令面板（Ctrl/Cmd + P）和自定义快捷键，可以实现全键盘操作。Vim 模式也提供了高效的键盘编辑体验。

如何让界面文字更大？

使用 Ctrl/Cmd + = 放大界面
在设置 → 外观中调整字体大小
在系统层面调整显示缩放

有专门的色盲模式吗？

Obsidian 没有内置色盲模式，但可以通过自定义 CSS 调整配色。推荐使用色盲友好的社区主题。

下一步

快捷键速查表 — 完整快捷键参考
Vim 模式 — 高效键盘编辑
自定义主题 — 主题定制指南
CSS 代码片段 — 界面自定义技巧

无障碍与辅助功能 ​

概述 ​

无障碍设计原则 ​

键盘导航 ​

全局快捷键 ​

文件导航 ​

编辑操作 ​

面板切换 ​

自定义快捷键 ​

Vim 模式 ​

屏幕阅读器支持 ​

支持的屏幕阅读器 ​

ARIA 支持 ​

屏幕阅读器使用技巧 ​

导航技巧 ​

编辑技巧 ​

已知限制 ​

视觉辅助 ​

缩放 ​

字体调整 ​

高对比度模式 ​

使用深色主题 ​

推荐高对比度主题 ​

自定义 CSS 增强 ​

色盲友好 ​

避免仅靠颜色传达信息 ​

调整配色方案 ​

专注与减少干扰 ​

专注模式 ​

减少动画 ​

简洁界面 ​

输入辅助 ​

语音输入 ​

模板减少输入 ​

自动补全 ​

移动端辅助功能 ​

iOS VoiceOver ​

Android TalkBack ​

移动端优化建议 ​

辅助工具推荐 ​

文本转语音 ​

语音转文字 ​

辅助插件 ​

反馈与改进 ​

报告无障碍问题 ​

参与改进 ​

常见问题 ​

Obsidian 对屏幕阅读器支持好吗？ ​

可以完全不用鼠标操作 Obsidian 吗？ ​

如何让界面文字更大？ ​

有专门的色盲模式吗？ ​

下一步 ​