Markdown 擴展功能

3 min

本文介紹 Retypeset 主題支援的 Markdown 擴展功能,包括語法示例與效果展示。

圖注

使用標準的 Markdown 圖像語法 ![alt](src),即可自動生成圖注。在 alt 前添加下劃線 _ 或留空 alt,即可隱藏圖注。

語法

![圖片描述](./full/or/relative/path/of/image)

![_圖片描述](./full/or/relative/path/of/image)

效果

圖片描述
圖片描述

_圖片描述

Github 倉庫卡片

使用雙冒號語法 ::github{repo="owner/repo"},即可創建 Github 倉庫卡片。在頁面載入後,從 GitHub API 中獲取倉庫數據。

語法

::github{repo="radishzzz/astro-theme-retypeset"}

效果

radishzzzastro-theme-retypeset

Loading repository data...

-- -- --

提示塊

使用 GitHub 語法 > [!TYPE] 或三冒號語法 :::type,即可創建提示塊。支援 notetipimportantwarningcaution 五種類型。

語法

> [!NOTE]
> 基礎的信息內容。

:::note
基礎的信息內容。
:::

:::note[自定義標題]
自定義標題的提示塊。
:::

效果

NOTE

基礎的信息內容。

TIP

實用的提示建議。

IMPORTANT

重要的通知提醒。

WARNING

緊急的事項說明。

CAUTION

嚴重的風險警告。

自定義標題

自定義標題的提示塊。