style(docs): привести разметку markdown к rumdl

README.md

@@ -39,7 +39,7 @@ pnpm run clear
 
 Сайт отдаёт MCP-сервер (Model Context Protocol), через который ИИ-агенты могут искать и читать документацию Hexlet. Эндпоинт:
 
-```
+```text
 https://help.hexlet.io/mcp
 ```
 

docs/career/praktika-v-kommercheskih-proektah.md

@@ -31,34 +31,34 @@ title: "Практика в коммерческих проектах"
 ## Какие есть проекты
 
 1. **Маркетинговый аналитик Telegram-каналов**
-    
-    Разрабатываем платформу для полной аналитики Telegram-каналов и автоматизации маркетинга.
-    Backlog проекта: https://github.com/Hexlet/tg-marketing-service/issues
+
+   Разрабатываем платформу для полной аналитики Telegram-каналов и автоматизации маркетинга.
+   Backlog проекта: https://github.com/Hexlet/tg-marketing-service/issues
 
 2. **Hexlet.CV**
-    
-    Онлайн-сервис для создания и публикации резюме, ориентированный на разработчиков, аналитиков, тестировщиков и специалистов смежных профессий.
-    Backlog проекта: https://github.com/Hexlet/hexlet-cv/issues
+
+   Онлайн-сервис для создания и публикации резюме, ориентированный на разработчиков, аналитиков, тестировщиков и специалистов смежных профессий.
+   Backlog проекта: https://github.com/Hexlet/hexlet-cv/issues
 
 3. **Runit**
-    
-    Онлайн-песочница для запуска кода прямо в браузере. Сервис позволяет писать, запускать и тестировать код на разных языках без необходимости установки локального окружения.
-    Backlog проекта: https://github.com/hexlet-rus/runit/issues
+
+   Онлайн-песочница для запуска кода прямо в браузере. Сервис позволяет писать, запускать и тестировать код на разных языках без необходимости установки локального окружения.
+   Backlog проекта: https://github.com/hexlet-rus/runit/issues
 
 4. **Аналитика вакансий**
-    
-    Сервис, который автоматически собирает вакансии с ключевых платформ (hh.ru, SuperJob, Habr Career, Telegram-каналы) и строит аналитику по IT-рынку труда.
-    Backlog проекта: https://github.com/Hexlet/hexlet-vacancy-analysis
+
+   Сервис, который автоматически собирает вакансии с ключевых платформ (hh.ru, SuperJob, Habr Career, Telegram-каналы) и строит аналитику по IT-рынку труда.
+   Backlog проекта: https://github.com/Hexlet/hexlet-vacancy-analysis
 
 5. **Hexlet SICP**
-    
-    Онлайн-версия классического курса Structure and Interpretation of Computer Programs (SICP), адаптированная для интерактивного обучения.
-    Backlog проекта: https://github.com/Hexlet/hexlet-sicp/issues
+
+   Онлайн-версия классического курса Structure and Interpretation of Computer Programs (SICP), адаптированная для интерактивного обучения.
+   Backlog проекта: https://github.com/Hexlet/hexlet-sicp/issues
 
 6. **Автопостинг**
-    
-    Сервис для автоматизации публикаций в социальных сетях. Он помогает планировать, создавать и размещать контент сразу в нескольких соцсетях через единый интерфейс.
-    Backlog проекта: https://github.com/Hexlet/hexlet-autoposting/tree/main
+
+   Сервис для автоматизации публикаций в социальных сетях. Он помогает планировать, создавать и размещать контент сразу в нескольких соцсетях через единый интерфейс.
+   Backlog проекта: https://github.com/Hexlet/hexlet-autoposting/tree/main
 
 ## Что нужно знать, чтобы начать
 
@@ -88,7 +88,7 @@ Issue помечаются лейблами, которые обозначают
 
 Если не уверены, актуальна ли задача или свободна ли она (например, кто-то написал, что забрал её, но так и не приступил), уточните это также в чате.
 
-**Когда нашли задачу, которую готовы выполнить:** 
+**Когда нашли задачу, которую готовы выполнить:**
 
 - напишите комментарий к задаче, что берёте её в работу,
 - сообщите об этом в чате проекта.
@@ -108,4 +108,4 @@ Issue помечаются лейблами, которые обозначают
 
 **Сообщайте обо всех сложностях**, которые возникают во время работы над проектом, менеджеру проекта и другим членам команды. В отличие от учебных задач, участие в коммерческих проектах Хекслета — это реальная разработка вместе с другими людьми. А значит, у вас есть отличная возможность получить опыт взаимодействия с командой, который пригодится и для работы в других компаниях.
 
-Команда поможет вам справиться с трудностями, но для этого нужно о них рассказать, поэтому не стесняйтесь просить о помощи. Это верно не только для технических, но и для организационных проблем: обязательно сообщайте, если вам не хватает времени на выполнение задачи или вы хотите отказаться от неё.
+Команда поможет вам справиться с трудностями, но для этого нужно о них рассказать, поэтому не стесняйтесь просить о помощи. Это верно не только для технических, но и для организационных проблем: обязательно сообщайте, если вам не хватает времени на выполнение задачи или вы хотите отказаться от неё.

docs/code-and-test-errors/kak-chitat-vyvod-testov-v-go/kak-chitat-vyvod-testov-v-go.md

@@ -12,21 +12,21 @@ title: "Как читать вывод тестов в Go"
 
 Когда тесты завершатся, на вкладке Вывод появится результат проверки. Если на этом этапе возникла ошибка, нужно прочитать вывод тестов. Этот вывод — наш главный помощник в отладке кода.
 
-# Виды ошибок
+## Виды ошибок
 
 Никто не пишет код идеально. Поэтому рано или поздно вы столкнетесь с ошибками. Ошибки при выполнении упражнения можно условно разделить на три вида:
 
-* Ошибки компиляции — это синтаксические ошибки, которые возникают еще на этапе компиляции программы
-* Ошибки времени исполнения – такие ошибки не мешают компиляции, но препятствуют выполнению программы
-* Ошибки утверждений — ошибки, вызванные тестами. Они возникают, если результат работы функции не соответствует ожидаемому результату
+- Ошибки компиляции — это синтаксические ошибки, которые возникают еще на этапе компиляции программы
+- Ошибки времени исполнения – такие ошибки не мешают компиляции, но препятствуют выполнению программы
+- Ошибки утверждений — ошибки, вызванные тестами. Они возникают, если результат работы функции не соответствует ожидаемому результату
 
-## Ошибки компиляции
+### Ошибки компиляции
 
 Например, к этому типу ошибок относятся:
 
-* Синтаксическая ошибка
-* Обращение к несуществующей переменной
-* Использование неправильных типов данных
+- Синтаксическая ошибка
+- Обращение к несуществующей переменной
+- Использование неправильных типов данных
 
 Если программа на Go написана синтаксически некорректно, то компилятор выводит на экран сообщение об ошибке.
 
@@ -36,11 +36,11 @@ title: "Как читать вывод тестов в Go"
 
 Сообщение об ошибке содержит:
 
-* Описание ошибки
-* Указание на файл, в котором произошла ошибка
-* Строчку в файле, где произошла ошибка
+- Описание ошибки
+- Указание на файл, в котором произошла ошибка
+- Строчку в файле, где произошла ошибка
 
-## Ошибки времени выполнения
+### Ошибки времени выполнения
 
 Эти ошибки не препятствуют компиляции, но при этом программа не работает так, как ожидается.
 
@@ -54,7 +54,7 @@ title: "Как читать вывод тестов в Go"
 
 Если описания недостаточно, всегда можно обратиться к документации, в которой описаны случаи возникновения тех или иных ошибок.
 
-## Ошибки утверждений
+### Ошибки утверждений
 
 Такие ошибки возникают, если результат работы функции не соответствует тому результату, который мы ожидали.
 
@@ -72,15 +72,15 @@ title: "Как читать вывод тестов в Go"
 
 Здесь мы видим:
 
-* Файл с тестами — `main_test.go`
-* Номер строки с непройденным тестом — `main_test.go:16`
-* Имя самого теста, который не прошел — `Test: TestSafeWrite`
-* Ожидаемый результат работы — в строчке `expected`
-* Фактический результат работы кода — в строчке `actual`
+- Файл с тестами — `main_test.go`
+- Номер строки с непройденным тестом — `main_test.go:16`
+- Имя самого теста, который не прошел — `Test: TestSafeWrite`
+- Ожидаемый результат работы — в строчке `expected`
+- Фактический результат работы кода — в строчке `actual`
 
 Изучив такой вывод, мы можем разобраться, чем вызвано несовпадение результатов. Это поможет устранить причину неправильной работы тестируемого кода.
 
-# Отладка кода
+## Отладка кода
 
 Иногда с первого взгляда невозможно понять, чем вызвано неправильное поведение кода. Тогда на помощь приходит отладка — возможность заглянуть в процесс выполнения кода.
 

docs/code-and-test-errors/kak-chitat-vyvod-testov-v-java.md

@@ -12,23 +12,23 @@ title: "Как читать вывод тестов в Java"
 
 Когда тесты завершатся, на вкладке Вывод появится результат проверки. Если на этом этапе возникла ошибка, нужно прочитать вывод тестов. Этот вывод — наш главный помощник в отладке кода.
 
-# Виды ошибок
+## Виды ошибок
 
 Никто не пишет код идеально. Поэтому рано или поздно вы столкнетесь с ошибками. Ошибки при выполнении упражнения можно условно разделить на три вида:
 
-* Ошибки компиляции — это синтаксические ошибки, которые возникают еще на этапе компиляции программы
-* Ошибки времени исполнения – такие ошибки не мешают компиляции, но препятствуют выполнению программы
-* Ошибки утверждений — ошибки, вызванные тестами. Они возникают, если результат работы функции не соответствует ожидаемому результату
+- Ошибки компиляции — это синтаксические ошибки, которые возникают еще на этапе компиляции программы
+- Ошибки времени исполнения – такие ошибки не мешают компиляции, но препятствуют выполнению программы
+- Ошибки утверждений — ошибки, вызванные тестами. Они возникают, если результат работы функции не соответствует ожидаемому результату
 
-## Ошибки компиляции
+### Ошибки компиляции
 
 Как видно из названия, такие ошибки возникают еще на этапе компиляции и препятствуют успешному компилированию кода. Они возникают из-за различного рода ошибок в самом тексте кода.
 
 Например, к этому типу ошибок относятся:
 
-* Синтаксическая ошибка — пропущенная точка с запятой, незакрытая скобка
-* Обращение к несуществующей переменной
-* Использование неправильных типов данных
+- Синтаксическая ошибка — пропущенная точка с запятой, незакрытая скобка
+- Обращение к несуществующей переменной
+- Использование неправильных типов данных
 
 Если программа на Java написана синтаксически некорректно, то компилятор выводит на экран сообщение об ошибке.
 
@@ -38,11 +38,11 @@ title: "Как читать вывод тестов в Java"
 
 Сообщение об ошибке содержит:
 
-* Описание ошибки
-* Указание на файл, в котором произошла ошибка
-* Строчку в файле, где произошла ошибка
+- Описание ошибки
+- Указание на файл, в котором произошла ошибка
+- Строчку в файле, где произошла ошибка
 
-## Ошибки времени выполнения
+### Ошибки времени выполнения
 
 Эти ошибки не препятствуют компиляции, но при этом программа не работает так, как ожидается.
 
@@ -60,7 +60,7 @@ title: "Как читать вывод тестов в Java"
 
 Если описания недостаточно, всегда можно обратиться к документации, в которой описаны случаи возникновения тех или иных исключений.
 
-## Ошибки утверждений
+### Ошибки утверждений
 
 Такие ошибки возникают, если результат работы функции не соответствует тому результату, который мы ожидали.
 
@@ -80,14 +80,14 @@ title: "Как читать вывод тестов в Java"
 
 Здесь мы видим:
 
-* Имя класса с тестами — `AppTest`
-* Имя самого теста, который не прошел — `testTruncate()`
-* Ожидаемый результат работы — в строчке `expected`
-* Фактический результат работы кода — в строчке `but was`
+- Имя класса с тестами — `AppTest`
+- Имя самого теста, который не прошел — `testTruncate()`
+- Ожидаемый результат работы — в строчке `expected`
+- Фактический результат работы кода — в строчке `but was`
 
 Изучив такой вывод, мы можем разобраться, чем вызвано несовпадение результатов. Это поможет устранить причину неправильной работы тестируемого кода.
 
-# Отладка кода
+## Отладка кода
 
 Иногда с первого взгляда невозможно понять, чем вызвано неправильное поведение кода. Тогда на помощь приходит отладка — возможность заглянуть в процесс выполнения кода.