Шпаргалка по Markdown: быстрая справка по синтаксису, форматированию и структуре
Быстрая справка по Markdown: заголовки, списки, код, таблицы и другое.
Язык разметки Markdown используется в Википедии и Hugo. Он поддерживает заголовки, списки, изменения стиля шрифта, изображения, цитаты кода и таблицы. Здесь я привел краткое резюме форматирования Markdown.
Это изображение выше создано Flux - текст в изображение ИИ.
Markdown — это легковесный язык разметки, который можно использовать для добавления элементов форматирования в текстовые документы в обычном тексте. Это руководство предоставляет всесторонний обзор наиболее часто используемого синтаксиса Markdown, помогая вам создавать хорошо структурированные и визуально привлекательные документы.
Эта шпаргалка является частью хаба Инструменты документации в 2026 году: Markdown, LaTeX, PDF и рабочие процессы печати.
Заголовки Markdown (H1–H6)
Заголовки в Markdown создаются с помощью символа решетки (#). Количество решеток перед текстом заголовка указывает уровень заголовка.
# H1
## H2
### H3
#### H4
##### H5
###### H6
Жирный, курсив и выделение
Markdown предоставляет несколько способов выделения текста. Вы можете использовать звездочки (*) или подчеркивания (_) для курсива и двойные звездочки (**) или двойные подчеркивания (__) для жирного.
Курсив
*Курсив* или _курсив_
Жирный
**Жирный** или __жирный__
Жирный и курсив
***Жирный и курсив*** или ___жирный и курсив___
Нумерованные и ненумерованные списки
Markdown поддерживает как нумерованные, так и ненумерованные списки.
Ненумерованный список
- Пункт 1
- Пункт 2
- Подпункт 1
- Подпункт 2
Нумерованный список
1. Первый пункт
2. Второй пункт
1. Подпункт 1
2. Подпункт 2
Гиперссылки в Markdown
Вы можете создавать ссылки, оборачивая текст ссылки в квадратные скобки ([]) и затем оборачивая URL в круглые скобки (()).
[Текст ссылки](URL)
Пример
Посетите [Руководство по Markdown](https://www.markdownguide.org/) для получения дополнительной информации.
Вставка изображений
Изображения добавляются с помощью восклицательного знака (!) за которым следует альтернативный текст в квадратных скобках и URL изображения в круглых скобках.
Пример
Блочные цитаты и вложенные цитаты
Блочные цитаты создаются с помощью символа больше чем (>).
> Это блочная цитата.
Вложенные блочные цитаты
> Это первый уровень цитирования.
>> Это вложенная цитата.
Встроенный код и блоки кода
Вы можете добавить встроенный код, обернув его в обратные кавычки (`). Для блоков кода используйте тройные обратные кавычки (```) до и после кода.
Встроенный код
Используйте `printf()` для вывода текста в C.
Блоки кода
```python
python def hello_world(): print("Hello, World!")
```
Больше о блоках кода в Markdown — см. отдельный пост: Использование блоков кода в Markdown
Горизонтальные правила (разделители)
Горизонтальные правила создаются с помощью трех или более тире (—), звездочек (***) или подчеркиваний (__).
---
Таблицы
Таблицы в Markdown создаются с помощью вертикальных линий (|) и дефисов (-).
Пример
| Заголовок 1 | Заголовок 2 |
|-------------|------------|
| Ячейка 1 | Ячейка 2 |
| Ячейка 3 | Ячейка 4 |
Для вариантов выравнивания, форматирования нескольких столбцов и функций, специфичных для GFM, см. Таблицы в Markdown: Полное руководство.
Списки задач (флажки)
Списки задач — это специальный тип списка, который позволяет создавать флажки.
Пример
- [x] Выполненная задача
- [ ] Незавершенная задача
Зачеркнутый текст
Зачеркнутый текст создается с помощью двойных тильд (~~).
~~Это зачеркнутый текст.~~
Выделение текста
Выделение текста не поддерживается нативно в Markdown, но некоторые рендереры поддерживают его с использованием синтаксиса ==.
Пример
==Это выделенный текст.==
Подстрочные и надстрочные индексы
Подстрочные индексы создаются с помощью символа caret (^) перед текстом, а надстрочные индексы — с помощью символа тильда (~) перед текстом.
Пример
H~2~O — это вода.
E = mc^2
Математические уравнения (синтаксис LaTeX)
Математические уравнения можно добавлять с использованием синтаксиса LaTeX внутри знаков доллара ($).
Пример
$$ E = mc^2 $$
Экранирование специальных символов
Для экранирования специальных символов используйте обратную косую черту ().
Пример
\*Курсив\* или \_курсив\_
Это всесторонняя шпаргалка, охватывающая основной синтаксис Markdown, который вам нужен для создания хорошо оформленных документов. Для более продвинутых функций и настраиваемых параметров обратитесь к документации конкретного рендерера или дополнительным ресурсам. Если вы используете Hugo, Шпаргалка по командам Hugo — это удобное справочное руководство.
