Шпаргалка по Markdown — заголовки, списки, ссылки, картинки и таблицы на одной странице

Markdown — простой язык разметки текста: вы пишете обычные символы, а программа превращает их в оформление. Минимум, который закрывает 95% задач:

• # — заголовок;
• **жирный** и *курсив*;
• - — пункт списка;
• [текст](адрес) — ссылка;
• ![описание](картинка.png) — картинка;
• таблица — через вертикальные черты |.

Ниже всё это с примерами.

Заголовки

# Заголовок первого уровня
## Заголовок второго уровня
### Третьего

После решётки нужен пробел. В статье обычно один заголовок первого уровня, разделы — вторым.

Жирный, курсив, зачёркнутый

**жирный**  *курсив*  ***жирный курсив***  ~~зачёркнутый~~

Списки

- пункт
- ещё пункт
  - вложенный (два пробела отступа)

1. первый
2. второй

Ссылки и картинки

[Текст ссылки](https://example.com)
![Описание картинки](images/photo.png)

Описание картинки важно: его увидят, если картинка не загрузится, и его читают поисковики.

Цитаты

> Это цитата.

Код

Слово в тексте: `код` в обратных кавычках. Блок кода — три обратные кавычки до и после, можно указать язык:

```python
print("привет")
```

Таблицы

| Бот | Что делает | Цена |
|---|---|---|
| Кружки | видео → кружок | 5 ⭐ |
| Голосовые | MP3 → голосовое | 5 ⭐ |

Правила: первая строка — заголовки, вторая — разделитель из дефисов, в каждой строке одинаковое число столбцов. Выравнивание задаётся двоеточиями: |:---| — влево, |:---:| — по центру, |---:| — вправо.

Перенос строки и абзацы

• Новый абзац — пустая строка между строками текста.
• Перенос внутри абзаца — два пробела в конце строки или тег <br>.

Частая ошибка — ждать новую строку от простого Enter. Без пустой строки строки склеятся в одну.

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

1. Нет пробела после # или -: #Заголовок не станет заголовком.
2. Разное число столбцов в строках таблицы — таблица разваливается.
3. Звёздочки внутри слов иногда превращают кусок текста в курсив. Экранируйте обратной косой чертой: \*.
4. Пробел в адресе картинки — путь ломается. Заменяйте пробелы на %20 или не используйте их в именах файлов.

Где пригодится Markdown

• README проектов и инструкции.
• Заметки в Obsidian и похожих программах.
• Инструкции для ИИ-агентов — AGENTS.md, CLAUDE.md, скиллы в SKILL.md.
• Статьи для блогов: многие платформы, включая эту, принимают тексты в Markdown.

Чем открыть md-файл — в статье «Чем открыть md-файл», как превратить его в документ — «Markdown в Word и PDF».

Полезное — в канале

Я пишу статьи, заметки и инструкции для ИИ-агентов в Markdown каждый день. Свои приёмы и инструменты показываю в Telegram-канале.

Частые вопросы

Как сделать таблицу в Markdown?

Первая строка — заголовки через вертикальные черты, вторая — разделитель |---|---|, дальше строки данных. В каждой строке должно быть одинаковое число столбцов.

Как сделать ссылку в Markdown?

Текст ссылки в квадратных скобках, адрес в круглых: [Текст](https://example.com).

Как вставить картинку в Markdown?

Восклицательный знак, описание в квадратных скобках и путь в круглых: .

Как сделать перенос строки в Markdown?

Новый абзац — пустая строка. Перенос внутри абзаца — два пробела в конце строки или тег <br>.

Как выделить текст жирным в Markdown?

Двумя звёздочками с обеих сторон: **жирный**. Курсив — одной звёздочкой: *курсив*.