标注

使用标注可以在不打乱笔记行文的情况下添加额外内容。

要创建标注,将 [!info] 添加到引用块的第一行即可。其中 info 是 类型标识符。类型标识符决定了标注的外观。要查看所有可用类型,请参阅支持的类型

> [!info]
> 这是一个标注块。
> 它支持 **Markdown**、[[Internal links|内部链接]] 和 [[Embed files|嵌入]]!
> ![[Engelbart.jpg]]

Info

这是一个标注块。
它支持 Markdown内部链接 和 嵌入
Engelbart.jpg

Obsidian 发布服务中也原生支持标注。

Note

如果你同时使用 Admonitions 插件,应将其更新至 8.0.0 版本以上,以避免与标注功能冲突的问题。

修改标题

默认情况下,标注的标题是其类型标识符。你可以在类型标识符后添加文本来更改它:

> [!tip] 标注可以有自定义标题
> 就像这个一样。

标注可以有自定义标题

就像这个一样。

你甚至可以省略内容,创建仅带标题的标注:

> [!tip] 仅标题的标注

仅标题的标注

可折叠标注

你可以通过在类型标识符后添加加号(+)或减号(-)来使标注可折叠。

加号表示标注默认展开,减号表示标注收起。

> [!faq]- 标注可以折叠吗?
> 可以!在可折叠标注中,当标注收起时,内容会被隐藏。

标注可以折叠吗?

嵌套标注

你可以多层嵌套标注。

> [!question] 标注可以嵌套吗?
> > [!todo] 可以。
> > > [!example]  你甚至可以使用多层嵌套。

标注可以嵌套吗?

可以。

你甚至可以使用多层嵌套。

自定义标注

CSS 代码片段 和 第三方插件 可以定义自定义标注,甚至覆盖默认配置。

要定义自定义标注,需创建以下 CSS 代码:

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

data-callout 属性的值是你想要使用的类型标识符,例如 [!custom-question-type]

  • --callout-color 使用三个数字(0-255)定义背景颜色的红色、绿色和蓝色分量。
  • --callout-icon 是类型的图标,其可以是 lucide.dev 的图标 ID,或者一个 SVG 图标。

关于 lucide 图标版本的说明

Obsidian 定期更新 Lucide 图标。当前使用的版本如下所示。请在自定义标注中使用该版本或更早版本的图标。

Version 0.268.0
ISC License
Copyright (c) 2020, Lucide Contributors

SVG 图标

除了使用 Lucide 图标,你也可以使用 SVG 图标作为标注图标。

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

支持的类型

Obsidian 内置了多种标注类型。每种类型都带有不同的背景颜色和图标。

要使用这些默认样式,请将示例中的 info 替换为任何这些类型,比如 [!tip] 或 [!warning]

除非使用自定义标注,否则任何不支持的类型都会默认为 note 类型。类型标识符不区分大小写,但部分类型有别名。

Note

> [!note]
> Lorem ipsum dolor sit amet

Abstract

> [!abstract]
> Lorem ipsum dolor sit amet

别名:summarytldr


Info

> [!info]
> Lorem ipsum dolor sit amet

Todo

> [!todo]
> Lorem ipsum dolor sit amet

Tip

> [!tip]
> Lorem ipsum dolor sit amet

别名:hintimportant


Success

> [!success]
> Lorem ipsum dolor sit amet

别名:checkdone


Question

> [!question]
> Lorem ipsum dolor sit amet

别名:helpfaq


Warning

> [!warning]
> Lorem ipsum dolor sit amet

别名:cautionattention


Failure

> [!failure]
> Lorem ipsum dolor sit amet

别名:failmissing


Danger

> [!danger]
> Lorem ipsum dolor sit amet

别名:error


Bug

> [!bug]
> Lorem ipsum dolor sit amet

Example

> [!example]
> Lorem ipsum dolor sit amet

Quote

别名:cite

Links to this page

基本格式语法

文档规范

Obsidian 风格的 Markdown 语法

Comments

No comments yet. Why don’t you start the discussion?

发表回复

您的电子邮箱地址不会被公开。 必填项已用 * 标注