Структура урока

Урок – это один markdown-файл. Всё, что вы читаете до заданий, – тело этого файла: абзацы, заголовки, списки, блоки кода. Обычный markdown, никакой разметки платформы.

Что во frontmatter

Задания. У них есть структура – варианты ответа, правильный индекс, объяснение, – и выразить её текстом нельзя. Поэтому они лежат в steps, в порядке прохождения:

steps:
  - type: quiz
    question: Вопрос
    options: [Первый, Второй]
    correct: 1
    why: Объяснение

Типов шагов три: quiz, text и code. Теория всегда идёт первой и отдельно не объявляется – она и есть тело файла.

Где лежат файлы

docs/courses/test-course/
├── course.md
└── 01-osnovy/
    ├── module.md
    └── 01-struktura.md

Числовой префикс задаёт порядок. В адресе страницы его нет: 01-struktura.md открывается как /courses/test-course/osnovy/struktura/.

Порядок берётся из имени файла, а не из поля order. Значит, переставить уроки – это переименовать файлы, и заодно поменяются адреса страниц.