Push 163 file(s) from Obsidian
This commit is contained in:
@@ -0,0 +1,230 @@
|
||||
---
|
||||
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")
|
||||
Reference in New Issue
Block a user