reonokiy/blog
1
0
Fork 0
mirror of https://github.com/reonokiy/blog.nokiy.net.git synced 2025-06-17 03:56:19 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

docs: add multi-language markdown-extended-features post

Browse source
This commit is contained in:
radishzzz 2025-05-02 20:08:50 +01:00
parent 6c8a682f83
commit bdaf3da70c
7 changed files with 438 additions and 16 deletions
Download patch file Download diff file Expand all files Collapse all files

85
src/content/posts/guides/Markdown Extended Features-ru.md Normal file
View file

@ -0,0 +1,85 @@
---
title: Расширенные функции Markdown
published: 2025-04-25
tags:
- Руководство
toc: false
lang: ru
abbrlink: markdown-extended-features
---
Здесь представлены некоторые расширенные функции Markdown, поддерживаемые темой Retypeset, включая примеры синтаксиса и их стилистические эффекты.
## Подписи к изображениям
Для создания автоматических подписей к изображениям используйте стандартный синтаксис изображений Markdown `![alt](src)`. Чтобы скрыть подпись, добавьте подчёркивание `_` перед текстом `alt` или оставьте текст `alt` пустым.
### Синтаксис
```
![Описание изображения](./full/or/relative/path/of/image)
![_Описание изображения](./full/or/relative/path/of/image)
```
### Результат
![Описание изображения](https://image.radishzz.cc/image/gallery/06.webp)
![_Описание изображения](https://image.radishzz.cc/image/gallery/06.webp)
## Карточки репозиториев Github
Для создания карточки репозитория Github используйте синтаксис с двойным двоеточием `::github{repo="owner/repo"}`. Данные репозитория загружаются из API GitHub после загрузки страницы.
### Синтаксис
```
::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[ПОЛЬЗОВАТЕЛЬСКИЙ ЗАГОЛОВОК]
Это примечание с пользовательским заголовком.
:::