Markdown 擴展功能
5 min
本文介紹 Retypeset 主題支援的 Markdown 擴展功能，包括語法範例與效果呈現。
圖注
使用標準的 Markdown 圖像語法 ，即可自動生成圖注。在 alt 前添加下劃線 _ 或留空 alt，即可隱藏圖注。
語法
效果
提示塊
使用 GitHub 語法 > [!TYPE] 或三冒號語法 :::type，即可創建提示塊。支援 note、tip、important、warning 和 caution 五種類型。
語法
> [!NOTE]
> 即使快速瀏覽，也值得用戶留意的信息。
> [!TIP]
> 可選信息，可幫助用戶更輕鬆地完成操作。
> [!IMPORTANT]
> 用戶成功所需的關鍵信息。
:::warning
由於存在潛在風險，需要用戶立即關注的關鍵內容。
:::
:::caution
某些操作可能帶來的負面後果。
:::
:::note[自定義標題]
這是一個自定義標題的提示塊。
:::效果
NOTE即使快速瀏覽，也值得用戶留意的信息。
TIP可選信息，可幫助用戶更輕鬆地完成操作。
IMPORTANT用戶成功所需的關鍵信息。
WARNING由於存在潛在風險，需要用戶立即關注的關鍵內容。
CAUTION某些操作可能帶來的負面後果。
自定義標題這是一個自定義標題的提示塊。
折疊部分
使用三冒號語法 :::fold[title]，即可創建折疊部分。點擊標題可以展開或收起。
語法
:::fold[使用提示]
如果需要添加並非所有讀者都會感興趣的內容，可以將其放在折疊部分。
:::效果
使用提示
如果需要添加並非所有讀者都會感興趣的內容，可以將其放在折疊部分。
畫廊
使用三冒號語法 :::gallery，即可建立圖片畫廊。水平捲動以瀏覽更多圖片。
語法
:::gallery
:::效果
GitHub 倉庫
使用雙冒號語法 ::github{repo="owner/repo"}，即可創建 GitHub 倉庫卡片。在頁面載入後，從 GitHub API 中即時獲取倉庫數據。
語法
::github{repo="radishzzz/astro-theme-retypeset"}效果
Loading repository data...
視頻
使用雙冒號語法 ::youtube{id="videoId"}，即可嵌入視頻。
語法
::youtube{id="9pP0pIgP2kE"}
::bilibili{id="BV1sK4y1Z7KG"}效果
X 推文
使用雙冒號語法 ::tweet{url="tweetUrl"}，即可嵌入 X 推文卡片。
語法
::tweet{url="https://x.com/hachi_08/status/1906456524337123549"}