mirror of
https://github.com/reonokiy/blog.nokiy.net.git
synced 2025-06-16 11:41:17 +02:00
97 lines
1.9 KiB
Markdown
97 lines
1.9 KiB
Markdown
---
|
|
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]
|
|
> 基础的信息内容。
|
|
|
|
:::note
|
|
基础的信息内容。
|
|
:::
|
|
|
|
:::note[自定义标题]
|
|
自定义标题的提示块。
|
|
:::
|
|
```
|
|
|
|
### 效果
|
|
|
|
> [!NOTE]
|
|
> 基础的信息内容。
|
|
|
|
> [!TIP]
|
|
> 实用的提示建议。
|
|
|
|
> [!IMPORTANT]
|
|
> 重要的通知提醒。
|
|
|
|
:::warning
|
|
紧急的事项说明。
|
|
:::
|
|
|
|
:::caution
|
|
严重的风险警告。
|
|
:::
|
|
|
|
:::note[自定义标题]
|
|
自定义标题的提示块。
|
|
:::
|
|
|
|
<!-- <details>
|
|
<summary>
|
|
我有钥匙却无门，有空间却无房间。你能进入却无法离开。我是什么？
|
|
</summary>
|
|
键盘。
|
|
</details>
|
|
|
|
<figure>
|
|
<img src="https://image.radishzz.cc/picsmaller/03.webp">
|
|
<figcaption text-center="">Node 模块检查器 - 概览</figcaption>
|
|
</figure> -->
|