Skip to content

Синтаксис списков

Списки — важный способ организации информации. Markdown поддерживает упорядоченные и неупорядоченные списки, а также вложенные списки и списки задач.

Неупорядоченные списки

Базовый синтаксис

Используйте -, * или + для создания неупорядоченных списков:

markdown
- Элемент 1
- Элемент 2
- Элемент 3

* Элемент 1
* Элемент 2
* Элемент 3

+ Элемент 1
+ Элемент 2
+ Элемент 3

Результат:

  • Элемент 1
  • Элемент 2
  • Элемент 3

Рекомендации по выбору символа

СимволОсобенностьРекомендуемый сценарий
-Наиболее распространен, лакониченОбычно рекомендуется
*Согласуется с синтаксисом выделенияДля согласованности стиля
+Редко используетсяДля особого выделения

Совет: Сохраняйте согласованность символов по всему документу.

Упорядоченные списки

Базовый синтаксис

Используйте числа с точкой для создания упорядоченных списков:

markdown
1. Первый элемент
2. Второй элемент
3. Третий элемент

Результат:

  1. Первый элемент
  2. Второй элемент
  3. Третий элемент

Нумерация

Фактическое значение числа не имеет значения; Markdown автоматически сгенерирует правильную последовательность:

markdown
1. Первый элемент
3. Второй элемент
8. Третий элемент

Результат:

  1. Первый элемент
  2. Второй элемент
  3. Третий элемент

Начальный номер

Вы можете указать начальный номер:

markdown
3. Третий элемент
4. Четвертый элемент
5. Пятый элемент

Результат:

  1. Третий элемент
  2. Четвертый элемент
  3. Пятый элемент

Вложенные списки

Базовое вложение

Используйте отступ (2-4 пробела) для создания вложенных списков:

markdown
- Элемент уровня 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

Смешанное вложение

Упорядоченные и неупорядоченные списки могут быть вложены друг в друга:

markdown
1. Упорядоченный элемент 1
   - Неупорядоченный подэлемент 1.1
   - Неупорядоченный подэлемент 1.2
2. Упорядоченный элемент 2
   1. Упорядоченный подэлемент 2.1
   2. Упорядоченный подэлемент 2.2
      - Неупорядоченный подподэлемент 2.2.1
      - Неупорядоченный подподэлемент 2.2.2

Результат:

  1. Упорядоченный элемент 1
    • Неупорядоченный подэлемент 1.1
    • Неупорядоченный подэлемент 1.2
  2. Упорядоченный элемент 2
    1. Упорядоченный подэлемент 2.1
    2. Упорядоченный подэлемент 2.2
      • Неупорядоченный подподэлемент 2.2.1
      • Неупорядоченный подподэлемент 2.2.2

Многоабзацный контент в списках

Продолжение абзаца

Включите несколько абзацев в элемент списка:

markdown
1. Первый элемент

   Это второй абзац первого элемента. Используйте отступ, чтобы сохранить его в элементе списка.

2. Второй элемент

   Это второй абзац второго элемента.
   
   Это третий абзац второго элемента.

3. Третий элемент

Результат:

  1. Первый элемент

    Это второй абзац первого элемента. Используйте отступ, чтобы сохранить его в элементе списка.

  2. Второй элемент

    Это второй абзац второго элемента.

    Это третий абзац второго элемента.

  3. Третий элемент

Блоки кода

Включите блоки кода в список:

markdown
1. Установите зависимости

   ```bash
   npm install express
  1. Создайте сервер

    javascript
    const express = require('express');
    const app = express();
  2. Запустите сервер


### Цитаты

Включите цитаты в список:

```markdown
1. Подготовка

   > Убедитесь, что у вас достаточно места на диске
   > Рекомендуется не менее 10 ГБ

2. Начните установку

Списки задач

Базовый синтаксис

Используйте - [ ] для незавершенных задач, - [x] для завершенных задач:

markdown
- [x] Завершенная задача
- [ ] Незавершенная задача
- [x] Еще одна завершенная задача
- [ ] Задача для выполнения

Результат:

  • [x] Завершенная задача
  • [ ] Незавершенная задача
  • [x] Еще одна завершенная задача
  • [ ] Задача для выполнения

Вложенные списки задач

markdown
- [x] Планирование проекта
  - [x] Анализ требований
  - [x] Технические исследования
  - [ ] Разработка прототипа
- [ ] Этап разработки
  - [ ] Разработка интерфейса
    - [x] Макет страницы
    - [ ] Интерактивные функции
  - [ ] Разработка бэкенда
    - [ ] Проектирование API

Build by www.markdownlang.com