230 lines
10 KiB
Markdown
230 lines
10 KiB
Markdown
---
|
|
title: "Шпаргалка по Markdown - Самые полезные структуры и форматирование"
|
|
source: "https://www.glukhov.org/ru/post/2024/03/markdown-cheatsheet/"
|
|
author:
|
|
- "[[Рост Глухов | Персональный сайт и технический блог]]"
|
|
published: 2023-03-20
|
|
created: 2025-08-23
|
|
description: "Шпаргалка по Markdown - Самые полезные структуры и форматирование"
|
|
tags:
|
|
- "clippings"
|
|
---
|
|
Язык разметки [Markdown](https://www.glukhov.org/ru/post/2024/03/markdown-cheatsheet/ "Справочник по Markdown") используется в Википедии и [Hugo](https://www.glukhov.org/ru/post/2024/06/deploy-hugo-site-to-aws/ "Развертывание сайта Hugo на AWS S3"). Он поддерживает заголовки, списки, изменения стиля шрифта, изображения, цитаты кода и таблицы. Здесь я сохраняю краткое резюме форматирования Markdown.
|
|
|
|
 Это изображение выше создано [Flux - AI для генерации изображений по тексту](https://www.glukhov.org/ru/post/2024/09/flux-text-to-image/ "Flux 1 dev - AI для генерации изображений по тексту").
|
|
|
|
Markdown — это [легковесный](https://www.glukhov.org/ru/ "сайт, сгенерированный с помощью Hugo, очень легковесный") язык разметки, который можно использовать для добавления элементов форматирования в текстовые документы с обычным текстом. Это руководство предоставляет всесторонний обзор наиболее часто используемого [синтаксиса Markdown](https://www.glukhov.org/ru/post/2024/03/markdown-cheatsheet/ "Справочник по Markdown"), помогая вам создавать хорошо структурированные и визуально привлекательные документы.
|
|
|
|
## Заголовки
|
|
|
|
Заголовки в Markdown создаются с помощью символа решетки (#). Количество решеток перед текстом заголовка указывает уровень заголовка.
|
|
|
|
```md
|
|
# H1
|
|
## H2
|
|
### H3
|
|
#### H4
|
|
##### H5
|
|
###### H6
|
|
```
|
|
|
|
## Выделение
|
|
|
|
Markdown предоставляет несколько способов выделения текста. Вы можете использовать звездочки (\*) или подчеркивания (\_) для курсива и двойные звездочки (\*\*) или двойные подчеркивания (\_\_) для жирного.
|
|
|
|
Курсив
|
|
|
|
```md
|
|
*Курсив* или _курсив_
|
|
```
|
|
|
|
Жирный
|
|
|
|
```md
|
|
**Жирный** или __жирный__
|
|
```
|
|
|
|
Жирный и курсив
|
|
|
|
```md
|
|
***Жирный и курсив*** или ___жирный и курсив___
|
|
```
|
|
|
|
## Списки
|
|
|
|
Markdown поддерживает как нумерованные, так и ненумерованные списки.
|
|
|
|
Ненумерованный список
|
|
|
|
```md
|
|
- Пункт 1
|
|
- Пункт 2
|
|
- Подпункт 1
|
|
- Подпункт 2
|
|
```
|
|
|
|
Нумерованный список
|
|
|
|
```md
|
|
1. Первый пункт
|
|
2. Второй пункт
|
|
1. Подпункт 1
|
|
2. Подпункт 2
|
|
```
|
|
|
|
## Ссылки
|
|
|
|
Ссылки создаются путем заключения текста ссылки в квадратные скобки (\[\]) и затем заключения URL в круглые скобки (()).
|
|
|
|
```md
|
|
[Текст ссылки](URL)
|
|
```
|
|
|
|
Пример
|
|
|
|
```md
|
|
Посетите [Руководство по Markdown](https://www.markdownguide.org/) для получения дополнительной информации.
|
|
```
|
|
|
|
## Изображения
|
|
|
|
Изображения добавляются с помощью восклицательного знака (!), за которым следует альтернативный текст в квадратных скобках и URL изображения в круглых скобках.
|
|
|
|
```md
|
|
|
|
```
|
|
|
|
Пример
|
|
|
|
```md
|
|
|
|
```
|
|
|
|
## Блочные цитаты
|
|
|
|
Блочные цитаты создаются с помощью символа больше чем (>).
|
|
|
|
```md
|
|
> Это блочная цитата.
|
|
```
|
|
|
|
Вложенные блочные цитаты
|
|
|
|
```md
|
|
> Это первый уровень цитирования.
|
|
>> Это вложенная блочная цитата.
|
|
```
|
|
|
|
## Встроенный код и блоки кода
|
|
|
|
Встроенный код можно добавить, заключив его в обратные кавычки (\`). Для блоков кода используйте тройные обратные кавычки (\`\`\`) до и после кода.
|
|
|
|
Встроенный код
|
|
|
|
```md
|
|
Используйте \`printf()\` для вывода текста в C.
|
|
```
|
|
|
|
Блоки кода
|
|
|
|
```md
|
|
\`\`\`python
|
|
def hello_world():
|
|
print("Hello, World!")
|
|
\`\`\`
|
|
```
|
|
|
|
Больше о блоках кода в Markdown — см. отдельный пост: [Использование блоков кода Markdown](https://www.glukhov.org/ru/post/2025/07/markdown-codeblocks/ "Блоки кода Markdown - подробное описание")
|
|
|
|
## Горизонтальные правила
|
|
|
|
Горизонтальные правила создаются с помощью трех или более тире (—), звездочек (\*\*\*) или подчеркиваний (\_\_).
|
|
|
|
```markdown
|
|
---
|
|
```
|
|
|
|
## Таблицы
|
|
|
|
Таблицы в Markdown создаются с помощью вертикальных линий (|) и тире (-).
|
|
|
|
```md
|
|
Пример
|
|
| Заголовок 1 | Заголовок 2 |
|
|
|-------------|-------------|
|
|
| Ячейка 1 | Ячейка 2 |
|
|
| Ячейка 3 | Ячейка 4 |
|
|
```
|
|
|
|
## Списки задач
|
|
|
|
Списки задач — это специальный тип списков, который позволяет создавать флажки.
|
|
|
|
```md
|
|
Пример
|
|
- [x] Выполненная задача
|
|
- [ ] Незавершенная задача
|
|
```
|
|
|
|
## Зачеркнутый текст
|
|
|
|
Зачеркнутый текст создается с помощью двойных тильд (~~).
|
|
|
|
```md
|
|
~~Это зачеркнутый текст.~~
|
|
```
|
|
|
|
## Выделение
|
|
|
|
Выделение текста не поддерживается нативно в Markdown, но некоторые рендереры поддерживают его с использованием синтаксиса ==.
|
|
|
|
Пример
|
|
|
|
```md
|
|
==Это выделенный текст.==
|
|
```
|
|
|
|
## Подстрочные и надстрочные индексы
|
|
|
|
Подстрочные индексы создаются с помощью символа caret (^) перед текстом, а надстрочные индексы — с помощью символа тильда (~) перед текстом.
|
|
|
|
Пример
|
|
|
|
```md
|
|
H 2 O — это вода.
|
|
E = mc^2
|
|
```
|
|
|
|
## Математические формулы
|
|
|
|
Математические формулы можно добавлять с использованием синтаксиса LaTeX внутри знаков доллара ($).
|
|
|
|
Пример
|
|
|
|
```md
|
|
$$ E = mc^2 $$
|
|
```
|
|
|
|
## Экранирование символов
|
|
|
|
Для экранирования специальных символов используйте обратную косую черту ().
|
|
|
|
Пример
|
|
|
|
```md
|
|
\*Курсив\* или \_курсив\_
|
|
```
|
|
|
|
Это всесторонний справочник, который охватывает основной синтаксис Markdown, необходимый для создания хорошо отформатированных документов. Для более сложных функций и настраиваемых параметров обратитесь к документации конкретного рендерера или дополнительным ресурсам.
|
|
|
|
## Полезные ссылки
|
|
|
|
- [Использование блоков кода Markdown](https://www.glukhov.org/ru/post/2025/07/markdown-codeblocks/ "Блоки кода Markdown - подробное описание")
|
|
- [Справочник по Hugo](https://www.glukhov.org/ru/post/2022/hugo-cheatsheet/ "Справочник по Hugo - список и описание полезных команд статического генератора сайтов Hugo")
|
|
- [Отправка формы Google в сайте Hugo](https://www.glukhov.org/ru/post/2025/04/submit-form-in-hugo-website/ "Инструкции по отправке формы в сайте Hugo с использованием Google Forms")
|
|
- [Использование Gitea Actions для развертывания сайта Hugo на AWS S3](https://www.glukhov.org/ru/post/2025/06/using-gitea-actions-deploy-hugo-to-s3/ "Использование Gitea Actions для развертывания сайта Hugo на AWS S3")
|
|
- [Справочник по Bash](https://www.glukhov.org/ru/post/2024/04/bash-cheat-sheet/)
|
|
- [Справочник по LaTeX](https://www.glukhov.org/ru/post/2024/12/latex-cheat-sheet/ "Справочник по LaTeX - добавление таблиц, диаграмм, изображений, оглавления и других полезных примеров")
|
|
- [Справочник по Ollama](https://www.glukhov.org/ru/post/2024/12/ollama-cheatsheet/ "Справочник по Ollama")
|
|
- [Справочник по Docker](https://www.glukhov.org/ru/post/2024/10/docker-cheatsheet/ "список и описание наиболее частых и полезных команд Docker - справочник по Docker")
|
|
- [Самые популярные темы для Hugo](https://www.glukhov.org/ru/post/2025/05/top-hugo-themes/ "Лучшие темы для Hugo") |