--- id: 02-methodology updated: 2026-08-10 17:40 GMT+3 --- # Методика: какой блок выбрать Используйте эту таблицу для выбора блока под задачу. ## Быстрый выбор | Задача | Блок | |---|---| | FAQ, глоссарий, однородные пункты «заголовок → текст» | `:::acc` | | Равнозначные панели, сценарии | `:::tab` | | Термин ↔ определение, самопроверка | `:::flip` | | Проверка знаний | `:::test` | | Процесс с порядком, инструкция | `:::steps` | | Критерии, плюсы/минусы, «как надо» | `:::checklist` | | Контраст «плохо ↔ хорошо» | `:::compare` | | Важная оговорка, идея, правило | `!!!` или `:::important` | | Кликабельные точки на схеме | `:::hotspot` | | Две–три колонки вёрстки | `:::columns` | ## Когда что использовать ### Аккордеон (`:::acc`) Используйте для однородных пунктов: заголовок открывает пояснение по клику. Подходит для: - Глоссария: термин — заголовок, определение — тело. - FAQ: вопрос — заголовок, ответ — тело. - Подсказок к шагам, когда порядок не важен. Не путайте с `:::steps`. Аккордеон не нумерует пункты. ### Вкладки (`:::tab`) Используйте для равнозначных панелей с короткими ярлыками. Подходит для: - Вариантов: теория / практика, условие / решение. - «До и после» без морали «плохо/хорошо». Не используйте вкладки для контраста «плохо/хорошо». Для этого — `:::compare` или `:::checklist duo`. ### Карточки (`:::flip`) Используйте для самопроверки: вспомнил → перевернул → проверил. Лицо — тезис. Оборот — развёрнутый ответ. Глоссарий из 10+ терминов лучше делать аккордеоном. ### Тест (`:::test`) - `[test]` / `[verification]` — один правильный ответ. Обязателен минимум один `+` и один `-`. - `[think]` / `[narrative]` — опрос. Нет правильного ответа. Нейтральный `ok:`. Не ставьте `[test]` с искусственным `+` там, где подходит `[think]`. ### Шаги (`:::steps`) Используйте для процесса с порядком: инструкция, алгоритм, «сначала → потом». - `:::steps` — со стрелками между шагами. - `:::steps grid` — сетка без стрелок. Не используйте `:::steps` для норм без последовательности. Для этого — `:::important rule` или чеклист. ### Чеклист (`:::checklist`) Используйте для критериев, требований, списка «что проверить» или списка возможностей. - `+` в начале строки — зелёная галочка (плюс / фича / «как надо»). - `-` в начале строки — красный крест (минус / ошибка). - Список преимуществ или возможностей продукта — **все пункты с `+`**. Не используйте `-` как обычный маркер списка. - Одна колонка: `:::checklist`. - Две колонки: `:::checklist duo`. Тональность: `=== + …` / `=== - …`. Отличие от `:::compare`: чеклист — набор пунктов с ✓/✗. Сравнение — ровно 2 текстовые колонки. ### Тест (`:::test`) - Открытие только `:::test`. Режим `[test]` или `[think]` — отдельной строкой внутри блока. - Не пишите `:::test[test]` и не клеите режим к имени блока. ### Сравнение (`:::compare`) Используйте для контраста подходов. Ровно 2 колонки с заголовками. ### Важное (`:::important`) - Краткая оговорка: `!!! текст`. - Блок: `:::important idea` / `problem` / `solution` / `info` / `rule`. - Иконку система рисует сама. Не вставляйте эмодзи и символы иконок в текст. - Только короткая врезка. Не оборачивайте весь урок или статью в `:::important`. ### Хотспот (`:::hotspot`) Используйте для схемы или фото с кликабельными точками. Требуется реальная картинка `![…](url)`. Без маркеров блок ведёт себя как обычное изображение. ### Колонки (`:::columns`) Используйте для параллельной вёрстки: текст + врезка, две равные колонки. Пишите `:::columns` … `:::/columns`. Соотношение: пресет (`2:1`, `1:1:1`) или проценты через дефис (`70-30`). **Не** `50/50`. Разделитель — пустой `===`. Заголовки внутри — `###`. Не заменяйте колонками `:::compare` или `:::checklist duo`. В колонках нет семантики «плохо/хорошо». ## Не путать | Хотели | Не ставьте | Ставьте | |---|---|---| | Последовательность шагов | `:::acc` с «Шаг 1» в заголовках | `:::steps` | | Норма / принцип | `:::steps` | `:::important rule` | | Контраст «плохо / хорошо» | Две вкладки | `:::compare` | | Много пунктов ✓/✗ | `:::compare` | `:::checklist` или `:::checklist duo` | | Глоссарий 10+ терминов | Пачка `:::flip` | `:::acc` | | Опрос без верного ответа | `[test]` с искусственным `+` | `[think]` | | Две колонки | `50/50` в первой строке | `50-50` или `1:1` | | Заголовок в колонке | `=== Заголовок` | пустой `===` + `###` в теле | | Свой кликабельный UI (не штатный Q&A) | `:::test` / костыль из `compare` | `:::ai_widget` (после BRIEF, см. `05`) | ## Anti-patterns: wrong → right ### Шаги как аккордеон — нельзя Так нельзя: :::acc === Шаг 1 Откройте файл. === Шаг 2 Сохраните файл. :::/acc Так надо: :::steps === Откройте файл Дважды щёлкните по ярлыку. === Сохраните файл Ctrl+S или меню «Файл». :::/steps ### Норма как steps — нельзя Так нельзя: :::steps === Правило 1 Не храните пароли в чате. :::/steps Так надо: :::important rule Не храните пароли в чате. :::/important ### Плохо/хорошо вкладками — нельзя Так нельзя: :::tab === Плохо Длинный абзац без структуры. === Хорошо Список и заголовки. :::/tab Так надо: :::compare === Плохо Длинный абзац без структуры. === Хорошо Список и заголовки. :::/compare ### Колонки со слэшем — нельзя Так нельзя: :::columns 50/50 === Левая. === Правая. :::/columns Так надо: :::columns 50-50 === ### Левая Текст. === ### Правая Текст. :::/columns ### `=== Заголовок` в колонках — нельзя Так нельзя (в превью торчит сырой `===`): :::columns 1:1 === Левая Текст. === Правая Текст. :::/columns Так надо — пустой `===`, заголовок через `###` (см. пример выше). ### Опрос с фейковым «верным» — нельзя Так нельзя: :::test [test] === Как вам курс? + Отлично - Нормально ye: Верно! no: Неверно. :::/test Так надо: :::test [think] === Как вам курс? - Отлично - Нормально - Сложно ok: Спасибо за ответ! :::/test ### Режим теста на строке открытия — нельзя Так нельзя: :::test[test] === Вопрос? + Да - Нет :::/test Так надо: :::test [test] === Вопрос? + Да - Нет :::/test ### Фичи чеклистом с минусами — нельзя Так нельзя (все пункты красные ✗): :::checklist - Поддерживает мультимодальные запросы - Использует Query Fan-Out :::/checklist Так надо (зелёные ✓): :::checklist + Поддерживает мультимодальные запросы + Использует Query Fan-Out :::/checklist ### Весь урок в important — нельзя Так нельзя: открыть `:::important idea` в начале файла и закрыть `:::/important` в конце, а внутри — `#`, `##`, steps, compare. Так надо: обычный Markdown-каркас; `:::important` только на короткий акцент (несколько предложений). ### Блок в одну строку — нельзя Так нельзя: :::steps === Шаг 1 Текст. === Шаг 2 Текст. :::/steps Так надо: :::steps === Шаг 1 Текст. === Шаг 2 Текст. :::/steps То же для `:::compare` и `:::checklist duo`. ## Размещение и объём - Перед интерактивом добавьте короткую подводку — связующий текст. - Между блоками — связный текст. Не ставьте несколько интерактивов подряд без пояснений. - Внутри `:::acc`, `:::tab`, `:::flip` не ставьте заголовки `###`. Структура — только через `===` и текст. - В подводках не используйте штампы: «далее», «ниже», «удобно». Не выдумывайте несуществующих типов блоков. Используйте только идентификаторы из допустимого списка.