Markdown — язык разметки для быстрого форматирования текста. Вместо HTML-конструкций здесь используются привычные символы: решетки для заголовков, звездочки для выделения, дефисы для списков. При этом исходный файл остается читаемым где угодно — от «Блокнота» до GitHub. В статье — основы синтаксиса и ключевые возможности языка.
Базовый синтаксис включает заголовки, выделение текста, списки, ссылки, изображения, цитаты, код и таблицы.
Существуют расширения Markdown (GitHub Flavored Markdown, CommonMark), которые добавляют чекбоксы, зачеркнутый текст и подсветку кода.
Основные преимущества: читаемость в исходном виде, простота освоения, универсальность и поддержка на множестве платформ.
Markdown применяется в документации, README-файлах на GitHub, технических форумах, блогах, заметках и даже в мессенджерах для форматирования текста.
Что такое Markdown
Markdown — это язык разметки, который придумали Джон Грубер и Аарон Шварц в 2004 году. Их идея была проста: создать формат, который удобно читать и писать даже в исходном виде, без преобразования в красиво оформленный текст.
В отличие от HTML, где нужно запоминать десятки тегов, Markdown использует интуитивно понятные символы: звездочки, решетки, дефисы. Текст, написанный на нем, остается читаемым в любом блокноте, но при этом легко конвертируется в HTML, PDF или другие форматы.
Основные преимущества Markdown:
Простота изучения. Базовый синтаксис можно освоить за 15—20 минут.
Читаемость. Даже без рендеринга понятно, где заголовок, а где список.
Универсальность. Поддерживается GitHub, GitLab, Stack Overflow, Reddit, Notion, Obsidian и множеством других платформ.
Скорость работы. Форматировать текст можно, не отрывая рук от клавиатуры.
Важно знать, что существуют разные диалекты Markdown — расширения базового синтаксиса. Самые популярные: GitHub Flavored Markdown (GFM), CommonMark, MultiMarkdown. Они добавляют новые возможности: таблицы, чекбоксы, зачеркнутый текст, подсветку кода. Но основа у всех одинаковая.
Основы синтаксиса Markdown: элементы форматирования с примерами
Разберем базовые элементы, которых достаточно для создания большинства документов.
Заголовки
Для заголовков используется символ решетки #. Количество решеток соответствует уровню заголовка — от первого (самого крупного) до шестого. После решеток обязательно ставится пробел.
Например:
# Заголовок первого уровня ## Заголовок второго уровня ### Заголовок третьего уровня #### Заголовок четвертого уровня ##### Заголовок пятого уровня ###### Заголовок шестого уровня
Для заголовков первого и второго уровня есть альтернативный способ: подчеркнуть текст знаками равенства = или дефисами - на следующей строке.
Заголовок первого уровня ======================= Заголовок второго уровня ------------------------
Но для заголовков третьего уровня и далее способ работать не будет.
Выделение текста
Чтобы изменить начертание текста, его выделяют с двух сторон специальными символами.
Курсив — одна звездочка или одно подчеркивание с двух сторон: *текст* или _текст_.
Жирный — две звездочки или два подчеркивания: **текст** или __текст__.
Жирный курсив — три звездочки или три подчеркивания: ***текст*** или ___текст___.
Зачеркнутый— две тильды: ~~текст~~.
Списки
Маркированные списки создаются с помощью звездочки *, дефиса - или плюса +. Перед каждым пунктом ставится символ и пробел.
Например:
* Первый пункт * Второй пункт * Третий пункт
Если нужен маркированный список, пункт обозначается цифрой с точкой и пробелом: 1. Неважно, какие цифры вы напишете, Markdown пронумерует список автоматически по порядку.
Для вложенных списков нужно добавить отступ — два или четыре пробела перед маркером дочернего пункта.
Чекбоксы (задачи) доступны в диалекте GFM. Перед пунктом ставится дефис, а затем в квадратных скобках пробел (для пустого) или x (для отмеченного).
Цитаты
Чтобы оформить текст как цитату, перед ним нужно поставить угловую скобку >.
Пример: > Это цитата. Она может занимать несколько строк. > Каждая строка начинается с символа >. > Внутри цитаты можно использовать другие элементы > > и даже вкладывать цитаты друг в друга.
Ссылки
Самый простой способ вставить ссылку — заключить ее в угловые скобки: <https://example.com>.
Чтобы оформить ссылкой часть текста, используется конструкция [текст](ссылка). Можно добавить всплывающую подсказку, которая появляется при наведении: [текст](ссылка "подсказка").
Например: [Hi-Tech Mail](https://hi-tech.mail.ru/) Hi-Tech Mail](https://hi-tech.mail.ru/ "Проект Hi-Tech Mail")
Есть еще справочный метод, удобный, когда одна и та же ссылка встречается несколько раз. Сноски оформляются так: [текст][метка], а в конце документа дается расшифровка: [метка]: ссылка.
[Hi-Tech Mail][site] [site]: hi-tech.mail.ru/
Изображения
Синтаксис для картинок похож на ссылки, но перед квадратными скобками ставится восклицательный знак. В квадратных скобках пишется альтернативный текст, в круглых — путь к файлу.
 
Вставка кода
Код внутри строки выделяется обратными апострофами (`). Для многострочных блоков код обрамляют тремя обратными апострофами.
Например:Функция `print()` выводит текст.
Таблицы
Таблицы доступны в диалекте GFM. Столбцы разделяются вертикальной чертой |, а строка с заголовками отделяется от остальных дефисами.
| Столбец 1 | Столбец 2 | Столбец 3 | |-----------|-----------|-----------| | Ячейка 1 | Ячейка 2 | Ячейка 3 | | Ячейка 4 | Ячейка 5 | Ячейка 6 |
Шапка станет первой строкой, разделители выровняются в колонках, а вертикальные линии превратятся в границы между столбцами.
Можно выравнивать текст в столбцах. Для этого в строке с дефисами ставят двоеточия:
слева — для выравнивания по левому краю :---,
с двух сторон — для центрирования :---:,
справа — для выравнивания по правому краю ---:.
| По левому | По центру | По правому | |:----------|:---------:|-----------:| | Текст | Текст | Текст |
Разделители
Горизонтальную линию можно сделать с помощью трех и более звездочек, дефисов или подчеркиваний на отдельной строке.
Экранирование
Некоторые символы в Markdown выполняют служебную роль. Если они нужны в тексте сами по себе, перед ними ставится обратная косая черта .
Экранировать нужно: \ ` * _ { } [ ] ( ) # + - . ! |
Например, если строка начинается с решетки, Markdown воспримет ее как заголовок. Чтобы этого избежать, пишут: \# Не заголовок.
Где используется Markdown
Markdown — это стандарт для создания документации в IT-сфере. Перечислим основные сферы применения.
Разработка и документация. README-файлы в репозиториях GitHub и GitLab, техническая документация, статьи на Microsoft Learn, описания API, вики разработчиков.
Вопросы‑ответы и форумы. Stack Overflow и другие проекты Stack Exchange, многие технические форумы и Q&A‑платформы.
Блоги и сайты. Статические блоги на Jekyll/Hugo, платформы вроде Ghost, страницы личных сайтов и технических блогов.
Заметки и рабочие материалы. Приложения Obsidian, Notion, отдельные markdown-редакторы, конспекты, черновики статей и учебные материалы.
Мессенджеры и чаты. Форматирование текста в мессенджерах, на форумах и в комментариях (жирный, курсив, списки и т.п.).
Конвертация в другие форматы. Из Markdown часто генерируют HTML, PDF, DOCX, EPUB.
Вопросы и ответы
В разделе ответили на вопросы о языке разметки Markdown.
Чем Markdown отличается от HTML?
HTML гораздо мощнее и позволяет верстать сложные страницы, но он громоздок и требует закрывающих тегов. Markdown же создан для быстрого форматирования простых текстов. Его легко читать даже в исходном виде, и он не требует специальных редакторов.
Какой редактор Markdown выбрать?
Подойдет любой текстовый редактор — хоть «Блокнот». Но для удобства лучше использовать специализированные: Typora, Obsidian, VS Code с плагинами, онлайн-редакторы вроде StackEdit или Dillinger.
Как конвертировать Markdown в другие форматы?
Можно использовать утилиты командной строки (например, Pandoc), онлайн-конвертеры или функции экспорта в приложениях (Obsidian, Typora). Pandoc умеет конвертировать Markdown в HTML, PDF, DOCX, LaTeX и множество других форматов.
