Markdown — язык разметки текстов. Такие тексты легко писать и читать. Их можно без труда сконвертировать в HTML. Большинство программистов предпочитают Markdown для написания документации, описаний своих проектов, написания блогов и так далее.
«Язык разметки» — это просто набор соглашений, правил.
Допустим, что вы общаетесь с другом по СМС. В них нельзя сделать текст жирным или наклонным. Вы договариваетесь с другом: если я пишу * что-то * вот так между звездочками, то считай, что это наклонный текст. А если я пишу ** что-то ** между двумя звездочками, то считай, что это жирный текст. Вы придумали правила.
Markdown — это набор подобных правил.
Это краткий справочник основных элементов синтаксиса Markdown. Единого стандарта не существует и разные версии Markdown могут отличаться в деталях. Но базовые элементы из списка ниже поддерживаются во всех стандартах.
Для выделения кода (или любого неотформатированного текста) используются специальные символы — обратные тики: `
Иногда нужно добавить кусок кода в обычную строчку текста.
А иногда нужно вставить целый блок кода:
Непронумерованный список:
Пронумерованный список:
В пронумерованном списке можно использовать любые числа — это не важно. При конвертации в HTML или другой формат числа станут правильными и последовательными (1, 2, 3 и т.д.).
Markdown используется для простого и удобного форматирования текста без сложного кода, что делает его популярным среди писателей и разработчиков. Он позволяет легко конвертировать текст в другие форматы, такие как HTML, и поддерживается на многих платформах и инструментах.
Источник: https://ru.hexlet.io/blog/posts/markdown