Списки Markdown

Markdown поддерживаетупорядоченные спискиинеупорядоченные списки。


Маркированный список

Неупорядоченные списки используют звёздочки (*), знаки плюса (+) или знаки минуса (-) в качестве маркеров списка. Добавьте пробел после этих маркеров, затем заполните содержимое:

* First item
* Second item
* Third item

+ First item
+ Second item
+ Third item


- First item
- Second item
- Third item

Отображаемый результат выглядит следующим образом:

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

  • Рекомендуется единообразно использовать знак минуса-, потому что он визуально понятнее
  • Используйте единообразные стили маркеров в одном и том же документе
  • После символа маркера должен быть пробел

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

Упорядоченные списки используются для отображения шагов или элементов, имеющих обязательную последовательность.

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

1. 第一项
2. 第二项
3. 第三项

Отображаемый результат выглядит следующим образом:

Числа могут быть непоследовательными

Markdown автоматически исправит порядок номеров:

1. 第一项
3. 第二项(实际显示为2)
7. 第三项(实际显示为3)

Начните с указанного номера:

5. 第五项
6. 第六项
7. 第七项


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

Советы по вложению списков

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

Вложенный неупорядоченный список:

- Fruits
  - Apples
    - Red apples
    - Green apples
  - Bananas
  - Oranges
- Vegetables
  - Carrots
  - Cabbage

Вложенный упорядоченный список:

1. 准备阶段
   1. 收集资料
   2. 制定计划
2. 执行阶段
   1. 开始实施
   2. 监控进度
3. 总结阶段

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

1. 主要任务
   - 子任务A
   - 子任务B
     1. 详细步骤1
     2. 详细步骤2
   - 子任务C
2. 次要任务

Для смешанных вложенных списков просто добавьте два или четыре пробела перед элементами подсписка:

1. 第一项:
    - 第一项嵌套的第一个元素
    - 第一项嵌套的第二个元素
2. 第二项:
    - 第二项嵌套的第一个元素
    - 第二项嵌套的第二个元素

Отображаемый результат выглядит следующим образом:

Правила вложения:

  • Подсписки должны иметь отступ в 2-4 пробела (рекомендуется 2)
  • Сохраняйте одинаковую длину отступа
  • Вложение может быть неограниченным, но на практике рекомендуется не превышать 3 уровней

Список задач (список с флажками)

Список задач — это расширение GitHub-flavored Markdown, которое теперь широко поддерживается:

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

- [ ] 未完成的任务
- [x] 已完成的任务
- [ ] 另一个未完成的任务

Результат отображения:

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

## 项目待办清单

### 设计阶段
- [x] 需求分析
- [x] 原型设计
- [ ] UI 设计

### 开发阶段
- [ ] 前端开发
  - [x] 页面布局
  - [ ] 交互功能
  - [ ] 响应式适配
- [ ] 后端开发
  - [ ] 数据库设计
  - [ ] API 开发
  - [ ] 性能优化

### 测试阶段
- [ ] 单元测试
- [ ] 集成测试
- [ ] 用户验收测试

Советы по использованию:

  • Пробел и x внутри квадратных скобок важны:[ ]и[x]
  • Можно использовать в сочетании с вложенными списками
  • Особенно полезно в управлении проектами, учебных планах и жизненных чек-листах
  • Некоторые редакторы поддерживают нажатие на флажок для переключения его состояния

Продвинутые советы по спискам:

Элементы списка, содержащие несколько абзацев:

1. 第一项

   这是第一项的详细说明,需要与列表项对齐缩进。
   
   还可以包含第二段内容。

2. 第二项

   > 可以在列表项中使用引用

Переносы строк в элементах списка:

- This is a very long list item that
  needs to be wrapped to a new line. Note that the second line needs to align with the first line.
- Another list item

Освоив эти базовые синтаксические конструкции, вы уже сможете создавать хорошо структурированные, правильно отформатированные Markdown-документы. Эти синтаксические конструкции наиболее часто используются в повседневной работе с текстом, а их освоение значительно повысит эффективность написания документов.

Другие расширения