使用標註塊在不打斷筆記閱讀流程的情況下加入額外內容。 要建立標註塊,請在區塊引用的第一行加上 `[!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`