Skip to content

斜杠命令

斜杠命令(Slash Commands)是 Obsidian 内置的快速操作功能,通过在编辑器中输入 / 可以快速调用各种操作,无需离开编辑状态。

基本使用

触发斜杠命令

  1. 在编辑器中输入 /
  2. 会弹出命令菜单
  3. 输入关键词筛选
  4. 选择后按 Enter 执行

触发位置

斜杠命令可以在以下位置触发:

  • 行首:在空行开头输入 /
  • 行中:在任意位置输入 /
  • 选中文本后:对选中内容应用格式

配置选项

可以在设置中调整触发行为:

设置 → 编辑器 → 斜杠命令 → 触发方式

内置命令

基础格式命令

命令功能示例
/h1插入一级标题# 标题
/h2插入二级标题## 标题
/h3插入三级标题### 标题
/h4 - /h6插入对应级别标题
/b插入粗体格式**文本**
/i插入斜体格式*文本*
/c插入行内代码`代码`
/q插入引用块> 引用
/-插入任务列表- [ ] 任务

内容插入命令

命令功能用途
/link插入内部链接链接到其他笔记
/img插入图片插入本地或网络图片
/table插入表格创建 Markdown 表格
/code插入代码块创建代码块
/math插入数学公式创建公式块
/file嵌入文件嵌入其他笔记
/hr插入分隔线创建水平线

Callout 命令

命令类型图标
/note备注📝
/tip提示💡
/warning警告⚠️
/info信息ℹ️
/success成功
/question问题
/failure失败
/danger危险
/bugBug🐛
/example示例📝
/quote引用💬

媒体嵌入命令

命令功能格式
/pdf嵌入 PDF![[文件.pdf]]
/audio嵌入音频![[音频.mp3]]
/video嵌入视频![[视频.mp4]]
/embed嵌入网页<iframe>

配置选项

启用/禁用斜杠命令

设置 → 编辑器 → 启用斜杠命令

触发方式设置

选项说明
仅在行首触发只有行首输入 / 才触发
任意位置触发任何位置输入 / 都触发

自动补全

设置 → 编辑器 → 斜杠命令自动补全

启用后,输入斜杠后会自动显示命令列表。

进阶技巧

快速搜索

输入斜杠后继续输入关键词快速定位:

/h1  → 直接插入一级标题
/tab → 查找表格相关命令
/cal → 查找 callout 相关命令
/tip → 直接插入 tip callout

缩写匹配

支持命令名称的缩写匹配:

输入匹配命令
h1一级标题
bdbold (粗体)
ititalic (斜体)
lklink (链接)
cdcode (代码)

文本选中后应用

先选中文本,再使用斜杠命令:

  1. 选中需要格式化的文本
  2. 输入 /
  3. 选择格式命令
  4. 格式将应用到选中文本

例如:

  • 选中文本 + /b → 文本加粗
  • 选中文本 + /c → 文本变为行内代码
  • 选中文本 + /q → 文本变为引用

多级菜单导航

部分命令有子菜单:

/table
  → /table:2x3  (2行3列表格)
  → /table:3x4  (3行4列表格)
  → /table:custom (自定义表格)

与 Templater 联动

Templater 是最强大的模板插件,与斜杠命令结合可以极大提升效率。

基本配置

  1. 安装 Templater 插件
  2. 设置模板文件夹
  3. 启用「在斜杠命令中显示模板」

插入模板命令

使用斜杠命令快速插入模板:

/templater:插入模板名称

例如:

  • /templater:日记 → 插入日记模板
  • /templater:会议记录 → 插入会议模板
  • /templater:读书笔记 → 插入读书笔记模板

创建模板快捷命令

在 Templater 设置中创建模板命令:

yaml
模板配置:
  模板文件夹: Templates
  自动插入:
    - 模板: 日记.md
      命令: daily
    - 模板: 会议.md
      命令: meeting
    - 模板: 读书笔记.md
      命令: book

之后可以直接使用:

  • /daily → 插入日记模板
  • /meeting → 插入会议模板
  • /book → 插入读书笔记模板

模板示例

日记模板

markdown
---
created: {{date:YYYY-MM-DD}}
tags: [日记]
---

# {{date:YYYY年MM月DD日}} 日记

## 今日计划

- [ ] 

## 工作记录

## 今日总结

## 明日计划

会议记录模板

markdown
---
created: {{date:YYYY-MM-DD HH:mm}}
tags: [会议]
attendees:
---

# 会议记录 - {{title}}

## 基本信息

- **时间**:{{date:YYYY-MM-DD HH:mm}}
- **参与人员**
- **议题**

## 讨论内容

## 决议事项

## 待办事项

- [ ]

与 QuickAdd 联动

QuickAdd 可以创建更复杂的工作流。

创建 QuickAdd 命令

  1. 打开 QuickAdd 设置
  2. 添加新选项
  3. 选择类型(模板、捕获、宏等)
  4. 配置选项

使用斜杠触发

QuickAdd 创建的选项会出现在斜杠命令中:

/QuickAdd:新建读书笔记
/QuickAdd:添加任务
/QuickAdd:快速捕获

自定义斜杠命令

使用 Commander 插件

Commander 可以添加自定义斜杠命令:

  1. 安装 Commander 插件
  2. 打开设置 → 斜杠命令
  3. 添加自定义命令

自定义命令示例

快速插入时间戳

yaml
命令名称: timestamp
触发: /ts
内容: |
  {{date:YYYY-MM-DD HH:mm:ss}}

快速插入分割线

yaml
命令名称: divider
触发: /div
内容: |
  ---
  
  ***
  
  ___

快速插入进度条

yaml
命令名称: progress
触发: /prog
内容: |
  进度: [▓▓▓▓▓▓░░░░] 60%

使用 CSS 片段

通过 CSS 创建自定义斜杠命令样式:

css
/* 自定义斜杠命令高亮 */
.cm-slash-command {
  color: var(--text-accent);
  font-weight: bold;
}

实用场景

写作工作流

1. /h1    → 章节标题
2. 输入内容
3. /h2    → 小节标题
4. 输入内容
5. /tip   → 添加提示框
6. /todo  → 添加任务项

会议记录

1. /meeting   → 插入会议模板
2. /-         → 记录待办事项
3. /q         → 记录重要引用
4. /table     → 插入议程表格
5. /warning   → 添加注意事项

代码笔记

1. /code:js   → JavaScript 代码块
2. /code:py   → Python 代码块
3. /tip       → 添加代码说明
4. /link      → 关联参考文档

项目管理

1. /daily     → 每日任务模板
2. /-         → 添加任务项
3. /link      → 关联项目笔记
4. /table     → 创建进度表

知识整理

1. /note      → 添加备注框
2. /link      → 链接相关笔记
3. /quote     → 引用重要内容
4. /tag       → 添加标签

代码块快捷命令

语言代码块

快速创建各种语言的代码块:

命令语言
/jsJavaScript
/tsTypeScript
/pyPython
/javaJava
/cppC++
/cssCSS
/htmlHTML
/jsonJSON
/yamlYAML
/sqlSQL
/bashBash
/shellShell
/markdownMarkdown
/mermaidMermaid 图表

与其他功能对比

斜杠命令 vs 命令面板

特性斜杠命令命令面板
触发方式/ 在编辑器中Ctrl+Shift+P
使用场景行内快速操作全局操作
快捷程度更快功能更全
插件支持部分插件所有插件
离开编辑
文本选中支持支持不支持

斜杠命令 vs 快捷键

特性斜杠命令快捷键
记忆难度低(可搜索)高(需记忆)
执行速度中等最快
可发现性
冲突可能
自定义性中等

选择建议

  • 常用操作:设置快捷键
  • 不常用操作:使用斜杠命令
  • 需要搜索的操作:使用命令面板

性能与问题

命令过多

如果斜杠命令列表过长:

  1. 在设置中禁用不常用命令
  2. 使用 Commander 管理命令显示
  3. 熟悉命令缩写直接输入

响应延迟

斜杠命令响应慢的可能原因:

  • 插件过多
  • 模板文件夹内容过多
  • 系统资源不足

冲突处理

如果斜杠命令与其他功能冲突:

  1. 检查是否有插件冲突
  2. 调整触发方式设置
  3. 修改冲突插件的快捷键

快速参考表

常用命令

命令效果类别
/h1 - /h6标题格式
/b粗体格式
/i斜体格式
/-任务列表格式
/link内部链接插入
/code代码块插入
/table表格插入
/note备注 CalloutCallout
/tip提示 CalloutCallout
/warning警告 CalloutCallout

模板命令

命令用途
/templater:模板名插入 Templater 模板
/QuickAdd:选项名执行 QuickAdd 选项

提示

熟练使用斜杠命令可以显著提升笔记效率。建议:

  1. 记住最常用的 10 个命令
  2. 配置 Templater 模板快捷命令
  3. 根据个人工作流定制命令
最后更新:2026年2月22日编辑此页反馈问题