Синтаксис списков
Списки — важный способ организации информации. Markdown поддерживает упорядоченные и неупорядоченные списки, а также вложенные списки и списки задач.
Неупорядоченные списки
Базовый синтаксис
Используйте -
, *
или +
для создания неупорядоченных списков:
- Элемент 1
- Элемент 2
- Элемент 3
* Элемент 1
* Элемент 2
* Элемент 3
+ Элемент 1
+ Элемент 2
+ Элемент 3
Результат:
- Элемент 1
- Элемент 2
- Элемент 3
Рекомендации по выбору символа
Символ | Особенность | Рекомендуемый сценарий |
---|---|---|
- | Наиболее распространен, лаконичен | Обычно рекомендуется |
* | Согласуется с синтаксисом выделения | Для согласованности стиля |
+ | Редко используется | Для особого выделения |
Совет: Сохраняйте согласованность символов по всему документу.
Упорядоченные списки
Базовый синтаксис
Используйте числа с точкой для создания упорядоченных списков:
1. Первый элемент
2. Второй элемент
3. Третий элемент
Результат:
- Первый элемент
- Второй элемент
- Третий элемент
Нумерация
Фактическое значение числа не имеет значения; Markdown автоматически сгенерирует правильную последовательность:
1. Первый элемент
3. Второй элемент
8. Третий элемент
Результат:
- Первый элемент
- Второй элемент
- Третий элемент
Начальный номер
Вы можете указать начальный номер:
3. Третий элемент
4. Четвертый элемент
5. Пятый элемент
Результат:
- Третий элемент
- Четвертый элемент
- Пятый элемент
Вложенные списки
Базовое вложение
Используйте отступ (2-4 пробела) для создания вложенных списков:
- Элемент уровня 1 - 1
- Элемент уровня 2 - 1.1
- Элемент уровня 2 - 1.2
- Элемент уровня 1 - 2
- Элемент уровня 2 - 2.1
- Элемент уровня 3 - 2.1.1
- Элемент уровня 3 - 2.1.2
- Элемент уровня 2 - 2.2
Результат:
- Элемент уровня 1 - 1
- Элемент уровня 2 - 1.1
- Элемент уровня 2 - 1.2
- Элемент уровня 1 - 2
- Элемент уровня 2 - 2.1
- Элемент уровня 3 - 2.1.1
- Элемент уровня 3 - 2.1.2
- Элемент уровня 2 - 2.2
- Элемент уровня 2 - 2.1
Смешанное вложение
Упорядоченные и неупорядоченные списки могут быть вложены друг в друга:
1. Упорядоченный элемент 1
- Неупорядоченный подэлемент 1.1
- Неупорядоченный подэлемент 1.2
2. Упорядоченный элемент 2
1. Упорядоченный подэлемент 2.1
2. Упорядоченный подэлемент 2.2
- Неупорядоченный подподэлемент 2.2.1
- Неупорядоченный подподэлемент 2.2.2
Результат:
- Упорядоченный элемент 1
- Неупорядоченный подэлемент 1.1
- Неупорядоченный подэлемент 1.2
- Упорядоченный элемент 2
- Упорядоченный подэлемент 2.1
- Упорядоченный подэлемент 2.2
- Неупорядоченный подподэлемент 2.2.1
- Неупорядоченный подподэлемент 2.2.2
Многоабзацный контент в списках
Продолжение абзаца
Включите несколько абзацев в элемент списка:
1. Первый элемент
Это второй абзац первого элемента. Используйте отступ, чтобы сохранить его в элементе списка.
2. Второй элемент
Это второй абзац второго элемента.
Это третий абзац второго элемента.
3. Третий элемент
Результат:
Первый элемент
Это второй абзац первого элемента. Используйте отступ, чтобы сохранить его в элементе списка.
Второй элемент
Это второй абзац второго элемента.
Это третий абзац второго элемента.
Третий элемент
Блоки кода
Включите блоки кода в список:
1. Установите зависимости
```bash
npm install express
Создайте сервер
javascriptconst express = require('express'); const app = express();
Запустите сервер
### Цитаты
Включите цитаты в список:
```markdown
1. Подготовка
> Убедитесь, что у вас достаточно места на диске
> Рекомендуется не менее 10 ГБ
2. Начните установку
Списки задач
Базовый синтаксис
Используйте - [ ]
для незавершенных задач, - [x]
для завершенных задач:
- [x] Завершенная задача
- [ ] Незавершенная задача
- [x] Еще одна завершенная задача
- [ ] Задача для выполнения
Результат:
- [x] Завершенная задача
- [ ] Незавершенная задача
- [x] Еще одна завершенная задача
- [ ] Задача для выполнения
Вложенные списки задач
- [x] Планирование проекта
- [x] Анализ требований
- [x] Технические исследования
- [ ] Разработка прототипа
- [ ] Этап разработки
- [ ] Разработка интерфейса
- [x] Макет страницы
- [ ] Интерактивные функции
- [ ] Разработка бэкенда
- [ ] Проектирование API