feat: add admonition functionality and markdown-extended-features article, improve blockquote styling

This commit is contained in:
radishzzz 2025-04-25 20:31:41 +01:00
parent ed527b3bab
commit 23ba4de450
13 changed files with 360 additions and 162 deletions

View file

@ -0,0 +1,73 @@
---
title: Markdown 扩展功能
published: 2025-04-25
tags:
- 指南
toc: false
lang: zh
abbrlink: markdown-extended-features
---
以下是 Retypeset 主题的 Markdown 扩展功能,包括语法示例与样式效果。
## 提示块
使用容器指令 `:::type` 或 GitHub 语法 `> [!TYPE]`,即可创建提示块。支持以下五种类型:`note``tip``important``warning``caution`
### 语法
```
:::note
Useful information that users should know, even when skimming content.
:::
> [!NOTE]
> Useful information that users should know, even when skimming content.
:::note{title="YOUR CUSTOM TITLE"}
This is a note with a custom title.
:::
```
### 效果
> [!NOTE]
> Useful information that users should know, even when skimming content.
> [!TIP]
> Helpful advice for doing things better or more easily.
> [!IMPORTANT]
> Key information users need to know to achieve their goal.
:::warning
Urgent info that needs immediate user attention to avoid problems.
:::
:::caution
Advises about risks or negative outcomes of certain actions.
:::
:::note{title="YOUR CUSTOM TITLE"}
This is a note with a custom title.
:::
## 图注
使用 Markdown 图像语法 `![alt](src)`**且上下均为空行**,即可自动生成图注。在 `alt` 前添加下划线 `_` 或留空 alt即可隐藏图注。
### 显示图注
```
![图片描述](./full/or/relative/path/of/image)
```
### 隐藏图注
```
![_图片描述](./full/or/relative/path/of/image)
![](./full/or/relative/path/of/image)
```

View file

@ -60,7 +60,7 @@ To add an image, add an exclamation mark `!`, followed by alt text in brackets `
### Syntax
```markdown
```
![Image Description](./full/or/relative/path/of/image)
```
@ -228,7 +228,7 @@ Including `<sup>` superscript, `<sub>` subscript, `<abbr>` abbreviation, `<del>`
### Syntax
```markdown
```html
H<sub>2</sub>O
X<sup>n</sup> + Y<sup>n</sup> = Z<sup>n</sup>

View file

@ -60,7 +60,7 @@ Para agregar una imagen, añada un signo de exclamación `!`, seguido de texto a
### Sintaxis
```markdown
```
![Descripción de la Imagen](./full/or/relative/path/of/image)
```
@ -228,7 +228,7 @@ Incluyendo superíndice `<sup>`, subíndice `<sub>`, abreviatura `<abbr>`, tacha
### Sintaxis
```markdown
```html
H<sub>2</sub>O
X<sup>n</sup> + Y<sup>n</sup> = Z<sup>n</sup>

View file

@ -60,7 +60,7 @@ abbrlink: markdown-style-guide
### 構文
```markdown
```
![画像の説明](./full/or/relative/path/of/image)
```
@ -228,7 +228,7 @@ abbrlink: markdown-style-guide
### 構文
```markdown
```html
H<sub>2</sub>O
X<sup>n</sup> + Y<sup>n</sup> = Z<sup>n</sup>

View file

@ -60,7 +60,7 @@ Itatur? Quiatae cullecum rem ent aut odis in re eossequodi nonsequ idebis ne sap
### Синтаксис
```markdown
```
![Описание изображения](./full/or/relative/path/of/image)
```
@ -228,7 +228,7 @@ Itatur? Quiatae cullecum rem ent aut odis in re eossequodi nonsequ idebis ne sap
### Синтаксис
```markdown
```html
H<sub>2</sub>O
X<sup>n</sup> + Y<sup>n</sup> = Z<sup>n</sup>

View file

@ -60,7 +60,7 @@ abbrlink: markdown-style-guide
### 語法
```markdown
```
![圖片描述](./full/or/relative/path/of/image)
```
@ -228,7 +228,7 @@ abbrlink: markdown-style-guide
### 語法
```markdown
```html
H<sub>2</sub>O
X<sup>n</sup> + Y<sup>n</sup> = Z<sup>n</sup>

View file

@ -60,7 +60,7 @@ abbrlink: markdown-style-guide
### 语法
```markdown
```
![图片描述](./full/or/relative/path/of/image)
```
@ -228,7 +228,7 @@ abbrlink: markdown-style-guide
### 语法
```markdown
```html
H<sub>2</sub>O
X<sup>n</sup> + Y<sup>n</sup> = Z<sup>n</sup>