Справочник Markdown: синтаксис с примерами

Markdown позволяет оформлять текст несколькими простыми символами. Базовый синтаксис осваивается за несколько минут, а затем можно добавить таблицы, списки задач и блоки кода.

Открыть инструмент: Редактор Markdown

Базовый синтаксис

ЭлементMarkdown
Заголовок# Название, ## Раздел, ### Подраздел
Жирный**текст** или __текст__
Курсив*текст* или _текст_
Ссылка[текст](https://example.com)
Изображение![описание](фото.jpg)
Список- пункт или 1. пункт
Цитата> текст
Перенос строкиДва пробела в конце строки

Расширенный синтаксис

Markdown в стиле GitHub добавляет таблицы из вертикальных черт и дефисов, списки задач с - [ ] и - [x], зачёркивание ~~двумя тильдами~~, блоки кода между тремя обратными апострофами и адреса сайтов, которые сами становятся ссылками.

Не все приложения поддерживают все расширения. Reddit и GitHub понимают таблицы, Discord — нет, а Slack использует свой упрощённый формат, поэтому проверяйте предпросмотр там, где будет опубликован текст.

Частые ошибки

  • Нет пустой строки перед списком или заголовком, и он сливается с предыдущим абзацем.
  • Пробел внутри звёздочек, например ** текст **, из-за которого жирный шрифт не работает.
  • Смешивание табуляции и пробелов во вложенных списках.
  • Пропущена строка из дефисов под заголовком таблицы.