Маркдаун, он же Markdown - удобный и быстрый способ разметки текста. Маркдаун используют, если недоступен HTML, а текст нужно сделать читаемым и хотя бы немного размеченным (заголовки, списки, картинки, ссылки).
Главный пример использования маркдауна, с которым мы часто сталкиваемся - файлы readme.md, которые есть в каждом репозитории на Гитхабе. md в имени файла это как раз сокращение от markdown.
Другой частый пример - сообщения в мессенджерах. Можно поставить звёздочки вокруг текста в Телеграме, и текст станет полужирным.
Версии маркдауна отличаются, поэтому перепроверьте, какую вы используете.
Выделение текста
У нас не очень много вариантов, но есть аналоги тегов <b> и <i>. И их тоже можно вкладывать друг в друга.
*Курсивный текст* или _курсивный текст_. **Полужирный текст** или __полужирный текст__. **Полужирный _наклонный_ текст_**
Заголовки
Чем больше раз повторяем #, тем больше уровень заголовка. Вообще доступно 6 уровней, но на практике очень редко нужно что-то больше третьего.
# h1 ## h2 ### h3 #### h4
Списки
Ненумерованный список - звёздочки с одной стороны. Второй уровень - ставим таб.
* Привет
* Как дела
* после таба получаем вложенный список
С нумерацией вообще смешно - можно просто везде поставить единички, а в документе появится уже нормально проставленная нумерация.
1. Да
1. Да-да
1. Да-да-да-да
1. Да-да-да-да-да
1. Да-да-да
Ссылки
[Текст ссылки](https://htmlacademy.ru)
Картинки ставятся как ссылки, только в начале добавляется восклицательный знак.
Цитаты
Это обычный текст, а > Цитируем вот так, и сразу видно, что это цитата
Всё, теперь вы можете написать свой первый Readme.md.
Source: HTML Academy