使用標註塊在不打斷筆記閱讀流程的情況下加入額外內容。
要建立標註塊,請在區塊引用的第一行加上 `[!info]`,其中 `info` 是_類型識別符_。類型識別符決定標註塊的外觀與風格。要查看所有可用的類型,請參考[[#支援的類型]]。標註塊在 [[Obsidian Publish 介紹|Obsidian Publish]] 上也有原生支援。
```markdown
> [!info] 這是標註塊標題
> 這是一個標註塊。
> 它支援 **Markdown**、[[內部連結|Wiki 連結]]和[[嵌入檔案|嵌入]]!
> ![[Engelbart.jpg]]
```
> [!info] 這是標註塊標題
> 這是一個標註塊。
> 它支援 **Markdown**、[[內部連結|Wiki 連結]]和[[嵌入檔案|嵌入]]!
> ![[Engelbart.jpg]]
你可以使用 `插入註標 (callout)` [[命令面板|命令]]來插入預設的 `[!note]` 標註塊。游標會自動定位在標註塊名稱欄位,讓你可以刪除預設名稱並輸入新名稱,然後再編輯內容。
要將現有內容包裹在標註塊中,請選取文字(包括清單、程式碼區塊等),然後執行 `插入註標 (callout)` 命令。選取的內容會自動被包裹在標註塊中。
在[[檢視與編輯模式#即時預覽|即時預覽]]中,你也可以對標註塊名稱按右鍵來變更標註塊類型。
### 變更標題
預設情況下,標註塊的標題是其類型識別符的首字母大寫形式。你可以在類型識別符後面加上文字來變更標題:
```markdown
> [!tip] 標註塊可以有自訂標題
> 像這樣。
```
> [!tip] 標註塊可以有自訂標題
> 像這樣。
你甚至可以省略內文來建立僅有標題的標註塊:
```markdown
> [!tip] 僅有標題的標註塊
```
> [!tip] 僅有標題的標註塊
### 可摺疊的標註塊
你可以在類型識別符後面直接加上加號(`+`)或減號(`-`)來讓標註塊可以摺疊。
加號表示預設展開標註塊,減號則表示預設收合。
```markdown
> [!faq]- 標註塊可以摺疊嗎?
> 可以!在可摺疊的標註塊中,收合時內容會被隱藏。
```
> [!faq]- 標註塊可以摺疊嗎?
> 可以!在可摺疊的標註塊中,收合時內容會被隱藏。
### 巢狀標註塊
你可以將標註塊巢狀放置多個層級。
```markdown
> [!question] 標註塊可以巢狀嗎?
> > [!todo] 可以!
> > > [!example] 你甚至可以使用多層巢狀。
```
> [!question] 標註塊可以巢狀嗎?
> > [!todo] 可以!
> > > [!example] 你甚至可以使用多層巢狀。
### 自訂標註塊
[[CSS 片段]]和[[社群外掛程式]]可以定義自訂標註塊,甚至覆寫預設的設定。
要定義自訂標註塊,請建立以下 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](https://lucide.dev) 的圖示 ID,或是 SVG 元素。
> [!warning] 關於 Lucide 圖示版本的注意事項
> Obsidian 會定期更新 Lucide 圖示。目前包含的版本如下所示;請在自訂標註塊中使用這些或更早的圖示。
> ![[致謝#^lucide]]
> [!tip] SVG 圖示
> 除了使用 Lucide 圖示之外,你也可以使用 SVG 元素作為標註塊圖示。
>
> ```css
> --callout-icon: '<svg>...自訂 svg...</svg>';
> ```
### 支援的類型
你可以使用多種標註塊類型和別名。每種類型都有不同的背景顏色和圖示。
要使用這些預設樣式,請將範例中的 `info` 替換為任何這些類型,例如 `[!tip]` 或 `[!warning]`。在即時預覽模式中,也可以對標註塊按右鍵來變更標註塊類型。
除非你[[#自訂標註塊]],否則任何不支援的類型都會預設為 `note` 類型。類型識別符不區分大小寫。
> [!note]
> ```md
> > [!note]
> > Lorem ipsum dolor sit amet
> ```
---
> [!abstract]-
> ```md
> > [!abstract]
> > Lorem ipsum dolor sit amet
> ```
別名:`summary`、`tldr`
---
> [!info]-
> ```md
> > [!info]
> > Lorem ipsum dolor sit amet
> ```
---
> [!todo]-
> ```md
> > [!todo]
> > Lorem ipsum dolor sit amet
> ```
---
> [!tip]-
> ```md
> > [!tip]
> > Lorem ipsum dolor sit amet
> ```
別名:`hint`、`important`
---
> [!success]-
> ```md
> > [!success]
> > Lorem ipsum dolor sit amet
> ```
別名:`check`、`done`
---
> [!question]-
> ```md
> > [!question]
> > Lorem ipsum dolor sit amet
> ```
別名:`help`、`faq`
---
> [!warning]-
> ```md
> > [!warning]
> > Lorem ipsum dolor sit amet
> ```
別名:`caution`、`attention`
---
> [!failure]-
> ```md
> > [!failure]
> > Lorem ipsum dolor sit amet
> ```
別名:`fail`、`missing`
---
> [!danger]-
> ```md
> > [!danger]
> > Lorem ipsum dolor sit amet
> ```
別名:`error`
---
> [!bug]-
> ```md
> > [!bug]
> > Lorem ipsum dolor sit amet
> ```
---
> [!example]-
> ```md
> > [!example]
> > Lorem ipsum dolor sit amet
> ```
---
> [!quote]-
> ```md
> > [!quote]
> > Lorem ipsum dolor sit amet
> ```
別名:`cite`