Расширенные функции Markdown

Здесь представлены некоторые расширенные функции Markdown, поддерживаемые темой Retypeset, включая примеры синтаксиса и их стилистические эффекты.

Подписи к изображениям

Для создания автоматических подписей к изображениям используйте стандартный синтаксис изображений Markdown ![alt](src). Чтобы скрыть подпись, добавьте подчёркивание _ перед текстом alt или оставьте текст alt пустым.

Синтаксис

![Описание изображения](https://image.radishzz.cc/image/gallery/06.webp)

![_Описание изображения](https://image.radishzz.cc/image/gallery/06.webp)

Результат

Блоки примечаний

Для создания блоков примечаний используйте синтаксис GitHub > [!TYPE] или контейнерную директиву :::type. Поддерживаются следующие типы: note, tip, important, warning и caution.

Синтаксис

> [!NOTE]
> Полезная информация, которую пользователи должны знать, даже при беглом просмотре.

> [!TIP]
> Полезные советы, как делать что-то лучше или проще.

> [!IMPORTANT]
> Ключевая информация, которую пользователи должны знать для достижения своей цели.

:::warning
Срочная информация, требующая немедленного внимания пользователя для предотвращения проблем.
:::

:::caution
Предупреждает о рисках или негативных последствиях определённых действий.
:::

:::note[ПОЛЬЗОВАТЕЛЬСКИЙ ЗАГОЛОВОК]
Это примечание с пользовательским заголовком.
:::

Результат

NOTE

Полезная информация, которую пользователи должны знать, даже при беглом просмотре.

TIP

Полезные советы, как делать что-то лучше или проще.

IMPORTANT

Ключевая информация, которую пользователи должны знать для достижения своей цели.

WARNING

Срочная информация, требующая немедленного внимания пользователя для предотвращения проблем.

CAUTION

Предупреждает о рисках или негативных последствиях определённых действий.

ПОЛЬЗОВАТЕЛЬСКИЙ ЗАГОЛОВОК

Это примечание с пользовательским заголовком.

Сворачиваемые разделы

Для создания сворачиваемых разделов используйте синтаксис контейнерной директивы :::fold[title]. Нажмите на заголовок, чтобы развернуть или свернуть раздел.

Синтаксис

:::fold[Советы по использованию]
Контент, который может не заинтересовать всех читателей, можно поместить в сворачиваемый раздел.
:::

Результат

Галереи

Для создания галерей изображений используйте контейнерную директиву :::gallery. Прокручивайте горизонтально, чтобы просмотреть больше изображений.

Синтаксис

:::gallery
![Альпака](https://image.radishzz.cc/image/gallery/sheep-1.jpg)
![Поворачивает голову](https://image.radishzz.cc/image/gallery/sheep-2.jpg)
![Зрительный контакт](https://image.radishzz.cc/image/gallery/sheep-3.jpg)
![Детёныш альпаки](https://image.radishzz.cc/image/gallery/sheep-4.jpg)
![Ой, какая прелесть!](https://image.radishzz.cc/image/gallery/sheep-5.jpg)
:::

Результат

Репозитории GitHub

Для создания карточки репозитория GitHub используйте листовую директиву ::github{repo="owner/repo"}. Данные репозитория в режиме реального времени загружаются из API GitHub после загрузки страницы.

Синтаксис

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

Результат

Видео

Для встраивания видео используйте листовую директиву ::youtube{id="videoId"}.

Синтаксис

::youtube{id="9pP0pIgP2kE"}

::bilibili{id="BV1sK4y1Z7KG"}

Результат

Твиты

Для встраивания карточек твитов используйте листовую директиву ::tweet{url="tweetUrl"}.

Синтаксис

::tweet{url="https://x.com/hachi_08/status/1906456524337123549"}

Результат