Флажки в Markdown

Флажки (также называемые списками задач) — отличный способ создавать списки дел, отслеживать прогресс и организовывать задачи в ваших Markdown документах. Они особенно полезны в GitHub, GitLab и других платформах, поддерживающих интерактивные флажки.

Основной синтаксис флажков

Синтаксис для флажков использует квадратные скобки с пробелом или 'x' внутри: 

- [ ] Неотмеченный флажок
- [x] Отмеченный флажок
- [ ] Еще один неотмеченный элемент

Результат:

  • Неотмеченный флажок

  • Отмеченный флажок
  • Еще один неотмеченный элемент

Важные правила синтаксиса

1. Требования к пробелам

  • •
    Должен быть пробел после дефиса: - [ ] не -[ ]
  • •
    Пробел внутри скобок для неотмеченных: [ ] не []
  • •
    Строчная буква 'x' для отмеченных: [x] не [X]

2. Формат списка

Флажки должны быть частью списка (используя -, + или *): 
- [ ] Это работает
* [ ] Это тоже работает
+ [ ] Это работает тоже

[ ] Это не работает (не в списке)

Вложенные флажки

Вы можете создавать вложенные списки задач с подзадачами: 

- [ ] Основная задача
  - [ ] Подзадача 1
  - [x] Подзадача 2 (выполнена)
  - [ ] Подзадача 3
- [x] Другая основная задача
  - [x] Её подзадача

Результат:

  • Основная задача

  • Подзадача 1
  • Подзадача 2 (выполнена)
  • Подзадача 3
  • Другая основная задача
  • Её подзадача

Практические примеры

Ежедневный список дел

## Задачи на сегодня

- [ ] Проверить электронную почту
- [ ] Просмотреть предложение проекта
- [x] Командная встреча в 10 утра
- [ ] Обновить документацию
- [ ] Спланировать работу на завтра

Планирование проекта

## Проект редизайна сайта

- [x] Фаза исследования
  - [x] Интервью с пользователями
  - [x] Анализ конкурентов
  - [x] Сбор требований
- [ ] Фаза дизайна
  - [x] Схематические модели
  - [ ] Визуальный дизайн
  - [ ] Прототип

Сочетание с другим форматированием

Вы можете комбинировать флажки с другим форматированием Markdown: 

- [x] **Важная задача** (выполнена)
- [ ] *Обычная задача* (в процессе)
- [ ] `Код-ревью` для проекта
- [ ] [Ссылка на документацию](https://example.com)
- [ ] ~~Отмененная задача~~ (зачеркнута)

Результат:

  • Важная задача (выполнена)

  • Обычная задача (в процессе)

  • Код-ревью для проекта

  • Ссылка на документацию
  • Отмененная задача (зачеркнута)

Устранение неполадок

Распространенные проблемы

  1. Флажок не отображается: Проверьте пробелы и формат списка

  2. Не интерактивен: Платформа может не поддерживать интерактивные флажки
  3. Непоследовательный внешний вид: Разные платформы стилизуют флажки по-разному

Правильный vs неправильный синтаксис

❌ Неправильно: 

-[ ] Нет пробела после дефиса
- [] Нет пробела в скобках
- [X] Заглавная X
[ ] Не в списке

✅ Правильно: 

- [ ] Пробел после дефиса
- [ ] Пробел в скобках
- [x] Строчная x

Флажки идеально подходят для организации задач и отслеживания прогресса. Они делают ваши документы интерактивными и помогают поддерживать организованность проектов!

Готовы добавить визуальный контент? Изучите изображения в Markdown далее.