--- url: /templates/editor.md description: >- Как устроен редактор шаблонов в панели Astral Moderation — режимы, синтаксис, панель инструментов, превью, справочник и горячие клавиши. --- # Редактор шаблона

Редактор шаблона выглядит одинаково во всех разделах панели: в приветствиях, в уровнях, в ответах команд и в пользовательских командах. Разберем, из чего он состоит.

## Поле шаблона { #field } Главная часть — текстовое поле, куда вы пишете сообщение. Это обычный текстовый редактор с подсветкой: * **островки кода** `{{ … }}`, `{% … %}` и `{# … #}` подсвечиваются цветом, чтобы их было видно среди текста; * при вводе `{{` редактор подсказывает переменные, доступные в этом месте, а после точки — их свойства (`member.` → `name`, `id`, `rank`…); * ошибки подчеркиваются прямо в тексте, а рядом написано, на какой строке и в каком столбце проблема. Шаблон может быть длиной до 16 КБ — это примерно 16 тысяч символов латиницей или 8 тысяч кириллицей. ## Режим и синтаксис { #mode } Над полем есть два переключателя. Их значения по умолчанию задаются для всего чата в разделе **«Общие»**, но у каждого шаблона их можно поменять. | Переключатель | Варианты | Что выбрать | |---|---|---| | Режим | **Rich** (по умолчанию) · **Text** | Rich — новые сообщения Telegram с заголовками, таблицами, списками и сворачиваемыми блоками. Text — классическое сообщение: только жирный, курсив, ссылки, цитаты и одно фото | | Синтаксис | **Markdown** (по умолчанию) · **HTML** | Markdown — разметка звездочками и решетками: `**жирный**`, `# Заголовок`. HTML — теги: `жирный`, `

Заголовок

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