用短代碼排版及插入特殊功能

短代碼是寫在 markdown 裡的特殊區塊,用 ::: 圍欄語法建立標準 markdown 沒有的版面與元件。青苔會為每個短代碼產生固定的類名,預設主題已經配好樣式。

多欄網格

:::grid N 把內容排成 N 欄,儲存格之間用 +++ 分隔。儲存格裡可以放任何 markdown——文字、圖片、連結、卡片。

:::grid 2
左欄內容

右欄內容

+++
::::grid 2
左欄內容
+++
右欄內容
::::
:::

在欄數後加 `a:b` 比例可設定各欄寬度,如 `:::grid 2 1:2`。只把一個內部連結單獨放進一格,青苔會把它算繪成帶封面的卡片。

## 標註

用 `> [!類型]` 開頭的引用區塊突顯重要內容,類型有 `note`、`tip`、`warning`、`pending` 等。

:::grid 2 {.sc-demo}
```markdown
> [!note] 提示
> 這裡是需要讀者留意的內容。

+++

提示

這裡是需要讀者留意的內容。 :::

其他常用短代碼

短代碼用途
::::buttons一排按鈕,每個是一個連結
:::hero鋪滿寬度的大圖,文字疊加其上
:::gallery圖片畫廊
::: {.類名}給一段內容附加 CSS 類,無需新短代碼

最後一種「命名類圍欄」最靈活:::: {.eyebrow} 之類給區塊掛上類名,再在 主題的 style.css 裡寫樣式即可,不必等待新的短代碼。

深入了解

每個短代碼的完整參數、儲存格規則、卡片自動轉換等,見英文文件 Shortcodes

青苔發佈