斜杠命令
斜杠命令(Slash Commands)是 Obsidian 内置的快速操作功能,通过在编辑器中输入 / 可以快速调用各种操作,无需离开编辑状态。
基本使用
触发斜杠命令
- 在编辑器中输入
/ - 会弹出命令菜单
- 输入关键词筛选
- 选择后按
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 | 危险 | ⚡ |
/bug | Bug | 🐛 |
/example | 示例 | 📝 |
/quote | 引用 | 💬 |
媒体嵌入命令
| 命令 | 功能 | 格式 |
|---|---|---|
/pdf | 嵌入 PDF | ![[文件.pdf]] |
/audio | 嵌入音频 | ![[音频.mp3]] |
/video | 嵌入视频 | ![[视频.mp4]] |
/embed | 嵌入网页 | <iframe> |
配置选项
启用/禁用斜杠命令
设置 → 编辑器 → 启用斜杠命令触发方式设置
| 选项 | 说明 |
|---|---|
| 仅在行首触发 | 只有行首输入 / 才触发 |
| 任意位置触发 | 任何位置输入 / 都触发 |
自动补全
设置 → 编辑器 → 斜杠命令自动补全启用后,输入斜杠后会自动显示命令列表。
进阶技巧
快速搜索
输入斜杠后继续输入关键词快速定位:
/h1 → 直接插入一级标题
/tab → 查找表格相关命令
/cal → 查找 callout 相关命令
/tip → 直接插入 tip callout缩写匹配
支持命令名称的缩写匹配:
| 输入 | 匹配命令 |
|---|---|
h1 | 一级标题 |
bd | bold (粗体) |
it | italic (斜体) |
lk | link (链接) |
cd | code (代码) |
文本选中后应用
先选中文本,再使用斜杠命令:
- 选中需要格式化的文本
- 输入
/ - 选择格式命令
- 格式将应用到选中文本
例如:
- 选中文本 +
/b→ 文本加粗 - 选中文本 +
/c→ 文本变为行内代码 - 选中文本 +
/q→ 文本变为引用
多级菜单导航
部分命令有子菜单:
/table
→ /table:2x3 (2行3列表格)
→ /table:3x4 (3行4列表格)
→ /table:custom (自定义表格)与 Templater 联动
Templater 是最强大的模板插件,与斜杠命令结合可以极大提升效率。
基本配置
- 安装 Templater 插件
- 设置模板文件夹
- 启用「在斜杠命令中显示模板」
插入模板命令
使用斜杠命令快速插入模板:
/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 命令
- 打开 QuickAdd 设置
- 添加新选项
- 选择类型(模板、捕获、宏等)
- 配置选项
使用斜杠触发
QuickAdd 创建的选项会出现在斜杠命令中:
/QuickAdd:新建读书笔记
/QuickAdd:添加任务
/QuickAdd:快速捕获自定义斜杠命令
使用 Commander 插件
Commander 可以添加自定义斜杠命令:
- 安装 Commander 插件
- 打开设置 → 斜杠命令
- 添加自定义命令
自定义命令示例
快速插入时间戳
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 → 添加标签代码块快捷命令
语言代码块
快速创建各种语言的代码块:
| 命令 | 语言 |
|---|---|
/js | JavaScript |
/ts | TypeScript |
/py | Python |
/java | Java |
/cpp | C++ |
/css | CSS |
/html | HTML |
/json | JSON |
/yaml | YAML |
/sql | SQL |
/bash | Bash |
/shell | Shell |
/markdown | Markdown |
/mermaid | Mermaid 图表 |
与其他功能对比
斜杠命令 vs 命令面板
| 特性 | 斜杠命令 | 命令面板 |
|---|---|---|
| 触发方式 | / 在编辑器中 | Ctrl+Shift+P |
| 使用场景 | 行内快速操作 | 全局操作 |
| 快捷程度 | 更快 | 功能更全 |
| 插件支持 | 部分插件 | 所有插件 |
| 离开编辑 | 否 | 否 |
| 文本选中支持 | 支持 | 不支持 |
斜杠命令 vs 快捷键
| 特性 | 斜杠命令 | 快捷键 |
|---|---|---|
| 记忆难度 | 低(可搜索) | 高(需记忆) |
| 执行速度 | 中等 | 最快 |
| 可发现性 | 高 | 低 |
| 冲突可能 | 低 | 高 |
| 自定义性 | 中等 | 高 |
选择建议
- 常用操作:设置快捷键
- 不常用操作:使用斜杠命令
- 需要搜索的操作:使用命令面板
性能与问题
命令过多
如果斜杠命令列表过长:
- 在设置中禁用不常用命令
- 使用 Commander 管理命令显示
- 熟悉命令缩写直接输入
响应延迟
斜杠命令响应慢的可能原因:
- 插件过多
- 模板文件夹内容过多
- 系统资源不足
冲突处理
如果斜杠命令与其他功能冲突:
- 检查是否有插件冲突
- 调整触发方式设置
- 修改冲突插件的快捷键
快速参考表
常用命令
| 命令 | 效果 | 类别 |
|---|---|---|
/h1 - /h6 | 标题 | 格式 |
/b | 粗体 | 格式 |
/i | 斜体 | 格式 |
/- | 任务列表 | 格式 |
/link | 内部链接 | 插入 |
/code | 代码块 | 插入 |
/table | 表格 | 插入 |
/note | 备注 Callout | Callout |
/tip | 提示 Callout | Callout |
/warning | 警告 Callout | Callout |
模板命令
| 命令 | 用途 |
|---|---|
/templater:模板名 | 插入 Templater 模板 |
/QuickAdd:选项名 | 执行 QuickAdd 选项 |
提示
熟练使用斜杠命令可以显著提升笔记效率。建议:
- 记住最常用的 10 个命令
- 配置 Templater 模板快捷命令
- 根据个人工作流定制命令