## Справочник

GitHub Markdown Callouts

Опубликовано март 2026

GitHub добавил синтаксис callout (alert) в GitHub Flavored Markdown. Эти стилизованные блоки выделяют важную информацию в документации -- заметки, советы, предупреждения и многое другое. ShowMeMyMD -- один из немногих десктопных просмотрщиков, которые их рендерят.

## Синтаксис

Пять типов callout-блоков

Callout-блоки используют синтаксис blockquote со специальным тегом в первой строке. Формат всегда одинаковый: > [!TYPE] с последующим содержимым на следующей строке, также с префиксом >.

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

NOTE -- Отображается как синий информационный блок. Используйте для дополнительного контекста, который полезен, но не критичен. Подумайте об этом как о информации «кстати».

> [!TIP]
> Полезный совет для улучшения
> или упрощения работы.

TIP -- Отображается как зеленый блок с советом. Используйте для лучших практик, горячих клавиш или рекомендаций, которые облегчат жизнь читателю.

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

IMPORTANT -- Отображается как фиолетовый блок выделения. Используйте для информации, критически важной для понимания перед продолжением. Не предупреждение, но то, что нельзя пропустить.

> [!WARNING]
> Срочная информация, требующая немедленного
> внимания для избежания проблем.

WARNING -- Отображается как желтый блок предупреждения. Используйте для потенциальных проблем, ловушек или вещей, которые могут пойти не так, если читатель не будет осторожен.

> [!CAUTION]
> Предупреждает о рисках или негативных
> последствиях определенных действий.

CAUTION -- Отображается как красный блок опасности. Зарезервируйте для необратимых операций, сценариев потери данных или действий, которые могут что-то сломать.

## Советы по использованию

Как писать эффективные callout-блоки

Используйте их экономно

Слишком много callout-блоков создают визуальный шум. Если все важно, то ничего не важно. Страница, полная цветных блоков, учит читателей игнорировать их. Один-два на раздел -- обычно правильное количество.

Соответствие типа серьезности

Не используйте CAUTION для небольшого совета. Не используйте NOTE для чего-то, что может удалить базу данных. Цветовая кодировка существует, чтобы дать читателям мгновенный сигнал о серьезности -- уважайте это.

Будьте кратким

Callout-блоки лучше всего работают с одним-тремя предложениями. Если вам нужно несколько абзацев, информация, вероятно, принадлежит основному тексту, а не callout-блоку.

Можно вкладывать другие элементы

Фрагменты кода, ссылки, жирный и курсив -- все работает внутри callout-блоков. Ставьте префикс > перед каждой строкой, чтобы содержимое оставалось внутри блока.

## Совместимость

Где callout-блоки рендерятся

Инструмент	Поддержка callout-блоков
GitHub (веб)	Полная -- цветные блоки с иконками
ShowMeMyMD	Полная -- стилизованные callout-блоки на десктопе
Некоторые расширения VS Code	Зависит от расширения
Большинство других Markdown-просмотрщиков	Нет -- показывают обычный blockquote
Стандартные рендереры CommonMark	Нет -- обычный blockquote
Старые парсеры GFM	Нет -- обычный blockquote

Большинство Markdown-просмотрщиков показывают просто blockquote.

ShowMeMyMD рендерит полный стилизованный callout -- цветная боковая полоса, иконка и корректное форматирование -- точно так, как это выглядит на GitHub. Если вы пишете README или документацию с callout-блоками, это один из немногих способов предпросмотра локально на Mac.

## Читайте далее

Узнайте больше о ShowMeMyMD как просмотрщике Markdown для Mac. Узнайте, почему разработчики выбирают его как просмотрщик Markdown для разработчиков. Или сохраните нашу шпаргалку по Markdown.

Предпросмотр callout-блоков локально

Перестаньте пушить на GitHub только для проверки callout-блоков. ShowMeMyMD рендерит NOTE, TIP, IMPORTANT, WARNING и CAUTION -- прямо на вашем Mac. $2.99 в Mac App Store.