Шпаргалка по Markdown: быстрый справочник по синтаксису, форматированию и структуре
Справочник по Markdown: заголовки, списки, код, таблицы и многое другое.
Язык разметки Markdown используется в Википедии и в Hugo. Он поддерживает заголовки, списки, изменение стилей шрифтов, изображения, цитаты кода и таблицы. Ниже приведено краткое резюме по форматированию в Markdown.
Изображение выше создано с помощью Flux - text to image AI.
Markdown — это легковесный язык разметки, который позволяет добавлять элементы форматирования в текстовые документы. Это руководство предоставляет подробный обзор наиболее часто используемого синтаксиса Markdown, помогая вам создавать структурированные и визуально привлекательные документы.
Этот шпаргалка является частью хабa Инструменты документации в 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. Идентификатор языка mermaid является одним из примечательных особых случаев — он запускает рендеринг диаграмм, а не подсветку синтаксиса, превращая обычный блок с разделителями в схему или диаграмму последовательности. В статье Быстрый старт с диаграммами Mermaid рассматривается полный синтаксис диаграмм от блок-схем до ER-диаграмм.
Горизонтальные линии (разделители)
Горизонтальные линии создаются с использованием трех или более тире (—), звездочек (***) или подчеркиваний (___).
---
Таблицы
Таблицы в 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 будет полезным справочным материалом.
Markdown также является форматом хранения по умолчанию для самостоятельно размещенных вики и систем знаний. DokuWiki использует подход на основе обычного текста, совместимый с Markdown, для персональных и командных баз знаний. Для систем знаний с использованием ИИ, построенных на страницах Markdown, статья LLM Wiki объясняет, почему портативность и возможность сравнения (diffability) этого формата делают его правильной основой для компилируемых знаний.
