Callout 提示块
Callout(标注块)源自 GitHub 的告警语法,是结构化笔记的利器。Tydora 支持 15 种内置类型,每种都有专属图标与配色,帮助你突出重要内容、区分信息层级。
Callout 在即时渲染模式下显示为彩色卡片;在源码模式下显示为带 [!TYPE] 的引用块。两种模式内容完全一致。
基本语法
Callout 基于引用块扩展,在 > 后紧跟 [!类型]:
> [!NOTE]
> 这是 Callout 的内容
类型列表
| 类型 | 语法 | 用途 |
|---|---|---|
| NOTE | [!NOTE] |
一般性备注 |
| TIP | [!TIP] |
小技巧或建议 |
| IMPORTANT | [!IMPORTANT] |
重要信息 |
| WARNING | [!WARNING] |
警告信息 |
| CAUTION | [!CAUTION] |
需要注意的事项 |
| ABSTRACT | [!ABSTRACT] |
摘要或概述 |
| INFO | [!INFO] |
信息说明 |
| SUCCESS | [!SUCCESS] |
成功或正向信息 |
| QUESTION | [!QUESTION] |
问题 |
| FAILURE | [!FAILURE] |
失败或错误信息 |
| DANGER | [!DANGER] |
危险警告 |
| BUG | [!BUG] |
Bug 相关 |
| EXAMPLE | [!EXAMPLE] |
示例 |
| QUOTE | [!QUOTE] |
引用内容 |
| FAQ | [!FAQ] |
常见问题 |
折叠控制
使用 + / - 修饰符控制 Callout 的默认展开状态:
> [!NOTE]+ → 默认展开
> [!NOTE]- → 默认折叠
> [!NOTE] → 默认展开(等效于 +)
点击标题栏可随时展开 / 折叠,折叠后仅显示标题。
使用示例
> [!TIP]
> 按 `Ctrl+S` 可以快速保存当前文件。
> [!WARNING]
> 删除文件后无法恢复,请谨慎操作。
> [!FAQ]-
> **Q: 如何切换编辑模式?**
> 按 `Ctrl+/` 可以在 IR / SV 模式间切换。
渲染效果:
按 Ctrl+S 可以快速保存当前文件。
删除文件后无法恢复,请谨慎操作。
Q: 如何切换编辑模式?按 Ctrl+/ 可以在 IR / SV 模式间切换。
多段落与嵌套
Callout 内部支持多段文字、列表、代码块等标准 Markdown 元素:
> [!EXAMPLE]
> 下面是一段示例代码:
> ```js
> console.log("hello");
> ```
> 也可以包含列表:
> - 项目一
> - 项目二
在即时渲染模式下,把光标放进 Callout 后使用 的「引用」命令,可快速将当前块转为 Callout 或调整类型。
相关文档
- 02-编辑器/02-Markdown语法 — 完整语法支持
- 02-编辑器/01-编辑模式 — 编辑模式介绍
- 02-编辑器/09-右键菜单 — 右键格式化命令