Callout 速查表
💡 Callout(标注块)是 Obsidian 的特色功能,用于突出显示重要内容,支持多种类型和自定义样式。
快速参考
基本语法
markdown
> [!类型] 标题
> 内容所有内置类型
| 类型 | 用途 | 图标 |
|---|---|---|
note | 普通笔记 | 📝 |
abstract / summary | 摘要 | 📋 |
info | 信息 | ℹ️ |
todo | 待办 | ✅ |
tip / hint | 提示 | 💡 |
success / check | 成功 | ✅ |
question / help | 问题 | ❓ |
warning / caution | 警告 | ⚠️ |
failure / fail / missing | 失败 | ❌ |
danger / error | 危险 | ⚡ |
bug | Bug | 🐛 |
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 |
| 错误处理 | danger 或 bug |
| 代码示例 | example |
| 引用内容 | quote |
| 总结概述 | abstract |
| 待办任务 | todo |
可读性建议
- 保持简洁:Callout 内容不宜过长
- 标题明确:使用描述性标题
- 适当嵌套:避免过多层级嵌套
- 类型一致:同类内容使用相同类型
性能考虑
- 大量 Callout 可能影响渲染性能
- 嵌套过深会增加解析时间
- 建议单页面 Callout 数量控制在 20 个以内