---
title: Markdown 扩展功能
published: 2025-04-25
tags:
- 指南
toc: false
lang: zh
abbrlink: markdown-extended-features
---
本文介绍 Retypeset 主题支持的 Markdown 扩展功能，包括语法示例与效果展示。
## 图注
使用标准的 Markdown 图像语法 ``，即可自动生成图注。在 `alt` 前添加下划线 `_` 或留空 `alt`，即可隐藏图注。
### 语法
```
```
### 效果
## Github 仓库卡片
使用双冒号语法 `::github{repo="owner/repo"}`，即可创建 Github 仓库卡片。在页面加载后，从 GitHub API 中实时获取仓库数据。
### 语法
```
::github{repo="radishzzz/astro-theme-retypeset"}
```
### 效果
::github{repo="radishzzz/astro-theme-retypeset"}
## 提示块
使用 GitHub 语法 `> [!TYPE]` 或三冒号语法 `:::type`，即可创建提示块。支持 `note`、`tip`、`important`、`warning` 和 `caution` 五种类型。
### 语法
```
> [!NOTE]
> 即使快速浏览，也值得用户留意的信息。
> [!TIP]
> 可选信息，可帮助用户更轻松地完成操作。
> [!IMPORTANT]
> 用户成功所需的关键信息。
:::warning
由于存在潜在风险，需要用户立即关注的关键内容。
:::
:::caution
某些操作可能带来的负面后果。
:::
:::note[自定义标题]
这是一个自定义标题的提示块。
:::
```
### 效果
> [!NOTE]
> 即使快速浏览，也值得用户留意的信息。
> [!TIP]
> 可选信息，可帮助用户更轻松地完成操作。
> [!IMPORTANT]
> 用户成功所需的关键信息。
:::warning
由于存在潜在风险，需要用户立即关注的关键内容。
:::
:::caution
某些操作可能带来的负面后果。
:::
:::note[自定义标题]
这是一个自定义标题的提示块。
:::
## 视频
从 YouTube 或其它视频平台获取嵌入代码，并粘贴至 markdown 文件中，即可创建视频。不需要保留 `width` 和 `height` 参数。
### 语法
```html
```
### 效果