Skip to content

Callout 速查表

💡 Callout(标注块)是 Obsidian 的特色功能,用于突出显示重要内容,支持多种类型和自定义样式。

快速参考

基本语法

markdown
> [!类型] 标题
> 内容

所有内置类型

类型用途图标
note普通笔记📝
abstract / summary摘要📋
info信息ℹ️
todo待办
tip / hint提示💡
success / check成功
question / help问题
warning / caution警告⚠️
failure / fail / missing失败
danger / error危险
bugBug🐛
example示例📝
quote引用💬

📝 基础用法

带标题

markdown
> [!note] 这是一个标题
> 这是 Callout 的内容。
> 支持多行文本。

无标题

markdown
> [!note]
> 没有标题的 Callout

纯标题

markdown
> [!tip] 快速提示

🎨 类型详解

note - 笔记

markdown
> [!note] 笔记
> 用于记录一般性笔记内容。
> 适合存储需要稍后查看的信息。

abstract / summary - 摘要

markdown
> [!abstract] 摘要
> 用于总结文章或章节的核心内容。

> [!summary] 总结
> 与 abstract 效果相同。

info - 信息

markdown
> [!info] 信息
> 用于提供补充信息或背景知识。
> 适合不需要特别强调的提示内容。

todo - 待办

markdown
> [!todo] 待办事项
> - [ ] 任务一
> - [ ] 任务二
> - [x] 已完成任务

tip / hint - 提示

markdown
> [!tip] 技巧提示
> 使用 `Ctrl/Cmd + P` 打开命令面板,快速执行命令。

> [!hint] 提示
> 与 tip 效果相同。

success / check - 成功

markdown
> [!success] 操作成功
> 数据已成功保存到本地。

> [!check] 验证通过
> 与 success 效果相同。

question / help - 问题

markdown
> [!question] 常见问题
> 如何在 Obsidian 中插入图片?
> 直接拖拽或粘贴即可。

> [!help] 需要帮助?
> 与 question 效果相同。

warning / caution - 警告

markdown
> [!warning] 注意事项
> 删除操作不可恢复,请谨慎操作。

> [!caution] 小心
> 与 warning 效果相同。

failure / fail / missing - 失败

markdown
> [!failure] 操作失败
> 无法连接到服务器,请检查网络。

> [!missing] 缺失内容
> 此部分内容待补充。

danger / error - 危险

markdown
> [!danger] 危险操作
> 此操作将永久删除所有数据!

> [!error] 错误
> 发生严重错误,请立即处理。

bug - Bug

markdown
> [!bug] 已知问题
> 在某些情况下,同步可能失败。
> 临时解决方案:手动刷新页面。

example - 示例

markdown
> [!example] 代码示例
> ```javascript
> function hello() {
>   console.log("Hello, Obsidian!");
> }
> ```

quote - 引用

markdown
> [!quote] 名言引用
> "知识就是力量。" — 培根

🔧 高级用法

可折叠

使用 + 默认展开,- 默认折叠:

markdown
> [!note]+ 默认展开
> 这是默认展开的内容。

> [!note]- 默认折叠
> 这是默认折叠的内容。
> 点击标题可以展开/折叠。

嵌套 Callout

markdown
> [!note] 外层笔记
> > [!tip] 内层提示
> > 嵌套的 Callout 内容。
>
> 回到外层内容。

多层嵌套

markdown
> [!warning] 多层嵌套
> > [!danger] 第二层
> > > [!bug] 第三层
> > > 深层嵌套的内容。

嵌入内容

markdown
> [!note] 嵌入其他笔记
> ![[其他笔记#章节]]

嵌入代码

markdown
> [!example] 代码示例
> ```python
> def hello():
>     print("Hello, World!")
> ```

嵌入表格

markdown
> [!info] 数据表格
> | 名称 | 数量 | 价格 |
> |------|------|------|
> | A | 10 | $100 |
> | B | 20 | $200 |

🎨 自定义 Callout

CSS 自定义

在 CSS 片段中添加:

css
/* 自定义 Callout 类型 */
.callout[data-callout="definition"] {
  --callout-color: 139, 92, 246;
  --callout-icon: lucide-book-open;
}

.callout[data-callout="theorem"] {
  --callout-color: 59, 130, 246;
  --callout-icon: lucide-lightbulb;
}

.callout[data-callout="lemma"] {
  --callout-color: 16, 185, 129;
  --callout-icon: lucide-git-branch;
}

.callout[data-callout="proof"] {
  --callout-color: 245, 158, 11;
  --callout-icon: lucide-check-circle;
}

.callout[data-callout="resources"] {
  --callout-color: 236, 72, 153;
  --callout-icon: lucide-folder-open;
}

使用自定义类型

markdown
> [!definition] 定义
> 这是一个自定义的定义 Callout。

> [!theorem] 定理
> 这是一个自定义的定理 Callout。

> [!lemma] 引理
> 这是一个自定义的引理 Callout。

> [!proof] 证明
> 这是一个自定义的证明 Callout。

> [!resources] 资源
> 这是一个自定义的资源 Callout。

常用图标参考

图标名称适用类型
lucide-book-open定义、概念
lucide-lightbulb想法、洞察
lucide-check-circle完成、验证
lucide-alert-circle注意、警告
lucide-help-circle问题、帮助
lucide-info信息、说明
lucide-star重点、收藏
lucide-code代码、示例
lucide-folder-open资源、文件
lucide-calendar日程、计划
lucide-user人物、用户
lucide-zap快速、效率

📋 实用模板

学习笔记

markdown
> [!definition] 核心概念
> 定义内容...

> [!theorem] 重要定理
> 定理内容...

> [!example] 示例
> 示例内容...

> [!tip] 记忆技巧
> 记忆技巧...

项目文档

markdown
> [!abstract] 项目概述
> 项目简介...

> [!info] 技术栈
> - 前端:React
> - 后端:Node.js
> - 数据库:PostgreSQL

> [!warning] 注意事项
> 重要提醒...

> [!todo] 待办事项
> - [ ] 任务1
> - [ ] 任务2

读书笔记

markdown
> [!quote] 精彩摘录
> 引用内容...

> [!note] 个人理解
> 我的理解...

> [!question] 思考问题
> 需要思考的问题...

> [!tip] 应用场景
> 实际应用...

技术文档

markdown
> [!info] 功能说明
> 功能描述...

> [!example] 使用示例
> ```code
> 示例代码
> ```

> [!warning] 已知限制
> 限制说明...

> [!bug] 已知问题
> 问题说明...

会议记录

markdown
> [!abstract] 会议摘要
> 会议核心内容...

> [!todo] 行动项
> - [ ] @张三 任务1
> - [ ] @李四 任务2

> [!warning] 风险提示
> 需要关注的风险...

🎯 最佳实践

类型选择指南

场景推荐类型
定义概念note 或自定义 definition
重要提示tip
警告内容warning
错误处理dangerbug
代码示例example
引用内容quote
总结概述abstract
待办任务todo

可读性建议

  1. 保持简洁:Callout 内容不宜过长
  2. 标题明确:使用描述性标题
  3. 适当嵌套:避免过多层级嵌套
  4. 类型一致:同类内容使用相同类型

性能考虑

  • 大量 Callout 可能影响渲染性能
  • 嵌套过深会增加解析时间
  • 建议单页面 Callout 数量控制在 20 个以内

🔗 相关阅读

最后更新:2026年3月14日编辑此页反馈问题