Callout 提示框

平平整整的笔记读久了会走神。Callout 是 Obsidian 给你的一支彩色荧光笔——把一段话装进带图标的彩色框里，立刻就能区分”提示""警告""例题""待办”。它从引用语法 > 演化而来，却比引用生动得多。

基本语法

> [!note]
> 这是一条普通的提示。

> 起头表示引用，[!type] 决定框的颜色与图标，下面每行继续以 > 开头。Callout 内部支持加粗、链接、嵌入，甚至可以再嵌 Callout。

也可以用命令面板的 “Insert callout” 快速插入，或选中已有内容再执行该命令，把段落”包裹”成 Callout。

完整类型清单

Obsidian 内置 12 种类型，每种都带别名：

类型	别名	视觉
note	—	蓝色，铅笔
abstract	summary tldr	青色，剪贴板
info	—	蓝色，信息圈
todo	—	蓝色，复选框
tip	hint important	青色，火苗
success	check done	绿色，对勾
question	help faq	黄色，问号
warning	caution attention	橙色，警告
failure	fail missing	红色，叉
danger	error	红色，闪电
bug	—	红色，虫子
example	—	紫色，列表
quote	cite	灰色，引号

任务清单里提到的 check/error/faq 都是上面类型的别名，写 [!check] 与 [!success] 完全等价。类型名不区分大小写，任何不识别的类型会回退成 note。

自定义标题

紧跟类型写一行文字即成标题：

> [!tip] 别忘了保存
> 按 Cmd+S 是徒劳的，Obsidian 自动保存。

只写标题不写正文，就是”标题型 Callout”，常用于章节内的醒目提醒：

> [!warning] 此处有坑

可折叠：- 与 +

在类型后加 - 默认折叠，加 + 默认展开但可折叠：

> [!faq]- 这道题的答案是什么？
> 42。

> [!faq]+ 这道题的答案是什么？
> 42。

折叠 Callout 是写长笔记的救星——把附录、推导、补充材料都收起来，正文一屏可读。

嵌套

Callout 内再缩进一层 Callout 即可嵌套：

> [!question] 能嵌套吗？
> > [!todo] 能。
> > > [!example] 甚至多层。

层数无硬性限制，但超过三层视觉就乱了，建议克制。

用 CSS 自定义

不喜欢的颜色或图标都能改。在 Settings → Appearance → CSS snippets 里新建一个片段：

.callout[data-callout="my-type"] {
  --callout-color: 255, 0, 0;
  --callout-icon: lucide-alert-circle;
}

之后用 > [!my-type] 即可调用。--callout-color 是 RGB 三数逗号分隔，--callout-icon 可填 lucide.dev 任意图标，也可以塞一段 SVG 字符串。

--callout-icon: '<svg>...自定义 SVG...</svg>';

注意 Obsidian 会定期更新内置的 Lucide 图标库，写自定义图标时尽量使用较早版本里就有的图标，避免升级后失效。

一个实用模板

> [!abstract] 摘要
> 本篇讨论 Callout 的用法。

> [!tip] 速记
> 折叠用 `-`，展开用 `+`。

> [!warning] 注意
> Callout 内的嵌入与链接都正常工作。

> [!faq]- 还有疑问？
> 看官方文档 help.obsidian.md/callouts。

---

Callout 是笔记的”表情”。用得克制，它让结构更清晰；用得泛滥，反而会让眼睛迷路。原则是：每屏不超过两三个，且只装”必须被注意”的内容。下一篇，我们离开文字，进入公式与图表的世界。