Редактор шаблона
Редактор шаблона выглядит одинаково во всех разделах панели: в приветствиях, в уровнях, в ответах команд и в пользовательских командах. Разберем, из чего он состоит.
Поле шаблона
Главная часть — текстовое поле, куда вы пишете сообщение. Это обычный текстовый редактор с подсветкой:
- островки кода
{{ … }},{% … %}и{# … #}подсвечиваются цветом, чтобы их было видно среди текста; - при вводе
{{редактор подсказывает переменные, доступные в этом месте, а после точки — их свойства (member.→name,id,rank…); - ошибки подчеркиваются прямо в тексте, а рядом написано, на какой строке и в каком столбце проблема.
Шаблон может быть длиной до 16 КБ — это примерно 16 тысяч символов латиницей или 8 тысяч кириллицей.
Режим и синтаксис
Над полем есть два переключателя. Их значения по умолчанию задаются для всего чата в разделе «Общие», но у каждого шаблона их можно поменять.
| Переключатель | Варианты | Что выбрать |
|---|---|---|
| Режим | Rich (по умолчанию) · Text | Rich — новые сообщения Telegram с заголовками, таблицами, списками и сворачиваемыми блоками. Text — классическое сообщение: только жирный, курсив, ссылки, цитаты и одно фото |
| Синтаксис | Markdown (по умолчанию) · HTML | Markdown — разметка звездочками и решетками: **жирный**, # Заголовок. HTML — теги: <b>жирный</b>, <h1>Заголовок</h1>. Выбирайте то, что вам привычнее |
Какой режим выбрать?
Оставьте Rich и Markdown — это самые удобные варианты. Режим Text нужен, если в чате много людей со старыми версиями Telegram, которые не показывают rich-сообщения (они появились в Telegram в июне 2026 года).
Еще два флажка:
- Справа налево (RTL) — для текстов на арабском, иврите и других языках, которые читают справа налево;
- Не превращать ссылки автоматически — Telegram не будет сам делать ссылками адреса сайтов,
@username,#хэштегии/командыв тексте.
Подробнее про режимы — в статье Rich-сообщения и разметка.
Панель инструментов
Кнопки над полем вставляют разметку за вас — не нужно помнить, сколько звездочек ставить. Выделите текст и нажмите кнопку, либо нажмите кнопку и начните печатать.
| Группа | Что вставляет |
|---|---|
| Текст | жирный, курсив, подчеркнутый, зачеркнутый, спойлер, маркер, код, верхний и нижний индекс |
| Блоки | заголовок, список, чек-лист, цитата, раскрывающаяся цитата, выноска, разделитель, подвал, сворачиваемый блок, формула |
| Таблица | конструктор строк и столбцов, выравнивание, рамки, полосы, компактность, подпись |
| Медиа | фото, видео, GIF, аудио, документ по ссылке https://, коллаж, слайдшоу, карта |
| Кнопки | кнопка под сообщением или ряд кнопок внутри текста: стиль, неактивность, действие |
| Данные | переменные и функции из справочника движка |
Островки кода панель инструментов не трогает: если выделить {{ member.name }} и нажать «Жирный», получится **{{ member.name }}**, а сам островок останется целым.
Превью
Справа от поля — превью в стиле Telegram: пузырь сообщения от имени бота с разметкой и кнопками. Превью обновляется, пока вы печатаете.
Превью строится на тестовых данных: вымышленный участник, чат и аргументы команды. Их можно поменять — например, указать уровень участника 25, чтобы проверить условие {% if member.rank.level >= 20 %}. Данные Astral (клубы, игроки) в превью тоже вымышленные.
Превью — приблизительное
Разные версии Telegram рисуют сообщения немного по-разному, поэтому превью похоже на настоящее сообщение, но не совпадает с ним до пикселя. Чтобы увидеть точный результат, отправьте тест себе в личные сообщения.
Отправить тест в ЛС
Кнопка «Отправить тест в ЛС» выполняет шаблон ботом на настоящих данных вашего чата и присылает результат вам в личные сообщения. Так можно проверить все: разметку, кнопки, данные Astral.
Чтобы бот мог написать вам, один раз откройте его в Telegram и нажмите «Запустить» (Start). Telegram не разрешает ботам писать первыми.
Справочник
Кнопка «Справочник» открывает боковую панель со всеми переменными, тегами и функциями, доступными в этом шаблоне. В ней есть поиск, а клик по элементу вставляет его в шаблон. Это удобный способ не запоминать названия.
Ошибки и предупреждения
Шаблон проверяется, пока вы печатаете, и еще раз при сохранении.
- Ошибка (красная) — шаблон нельзя выполнить: например, открыли
{% if %}и не закрыли{% endif %}. Пока ошибка не исправлена, бот этот шаблон не выполняет. - Предупреждение (желтое) — шаблон сработает, но, возможно, не так, как вы ждете: например, в режиме Text вы вставили таблицу, и она превратится в моноширинный текст. Предупреждения не мешают сохранению.
У каждой ошибки есть строка и столбец (например, 3:14 — третья строка, 14-й символ) и понятное описание. Список всех ошибок с объяснениями — в статье Ошибки, а самые частые разобраны в статье Частые ошибки.
Горячие клавиши
| Клавиши | Действие |
|---|---|
| Ctrl + S | Сохранить |
| F11 | Развернуть поле шаблона на весь экран, Esc — свернуть |
| Ctrl + B | Жирный |
| Ctrl + I | Курсив |
| Ctrl + U | Подчеркнутый |
| Ctrl + Shift + X | Зачеркнутый |
| Ctrl + K | Ссылка |
На Mac вместо Ctrl нажимайте Cmd.