Синтаксис Markdown - шпаргалка
Markdown – это легкий язык разметки для создания форматированного текста с использованием обычного текста. Он часто используется для написания документации, заметок, блогов и форматов на таких платформах, как GitHub, GitLab, Reddit и т. д. Вот основные элементы синтаксиса Markdown:
1. Заголовки
Для создания заголовков используется символ #
перед текстом. Количество символов #
указывает уровень заголовка.
# Заголовок 1 уровня
## Заголовок 2 уровня
### Заголовок 3 уровня
#### Заголовок 4 уровня
##### Заголовок 5 уровня
###### Заголовок 6 уровня
2. Абзацы
Простой текст автоматически форматируется в абзацы при наличии одной пустой строки между ними.
Это первый абзац.
Это второй абзац.
3. Выделение текста
-
Полужирный текст: два символа
**
или__
вокруг текста.**Это полужирный текст** или __Это тоже полужирный текст__
-
Курсив: один символ
*
или_
вокруг текста.*Это курсив* или _Это тоже курсив_
-
Зачеркнутый текст: два символа~~
вокруг текста.~~Этот текст зачеркнут~~
4. Списки
-
Нумерованные списки: Пронумерованные строки с точкой.
1. Первый пункт 2. Второй пункт 3. Третий пункт
-
Маркированные списки: Используются символы
-
,*
, или+
.- Элемент 1 - Элемент 2 - Элемент 3
5. Ссылки
-
Обычные ссылки: Текст ссылки обрамляется в квадратные скобки, а URL – в круглые скобки.
[Текст ссылки](http://example.com)
-
Ссылка с title-атрибутом: Можно добавить пояснение, которое будет отображаться при наведении мышки.
[Текст ссылки](http://example.com "Описание ссылки")
6. Изображения
Для вставки изображения используется тот же синтаксис, что и для ссылок, только перед текстом добавляется восклицательный знак.
![Описание изображения](http://example.com/image.jpg)
7. Цитаты
Для создания цитаты используется символ >
перед текстом. Можно вложить цитаты друг в друга.
> Это цитата.
>> Это вложенная цитата.
8. Блоки кода
-
Встраивание кода в строку: Используются одинарные обратные кавычки
`
для выделения кода внутри строки.Вот пример встроенного кода: `console.log("Hello, world!");`
-
Блок кода: Три обратные кавычки
```
открывают и закрывают блок кода. Также можно указать язык программирования для подсветки синтаксиса.```javascript function hello() { console.log("Hello, world!"); }
9. Горизонтальная линия
Горизонтальная линия создается с использованием трех или более символов ---
, ***
, или ___
.
---
10. Таблицы
Таблицы создаются с помощью вертикальных линий |
и тире -
для разделения заголовков и строк.
| Заголовок 1 | Заголовок 2 |
| ----------- | ----------- |
| Текст | Текст |
| Еще текст | Еще текст |
11. Вложенные элементы
Markdown позволяет комбинировать элементы. Например, можно добавить список внутри цитаты или использовать ссылки внутри заголовков.
> ### Цитата с заголовком
> - Элемент списка внутри цитаты
> - Еще один элемент
12. Специальные символы
Чтобы использовать символы Markdown как обычные символы (например, *
, #
, и т. д.), перед ними нужно поставить обратный слэш \
.
\*Эта звездочка не будет восприниматься как курсив.*
13. Автоматические ссылки
Для автоматического создания ссылки достаточно просто написать URL или email:
http://example.com
email@example.com
14. HTML в Markdown
В Markdown можно использовать HTML-теги для более сложных элементов (например, для таблиц, изображений с определенным размером и т.д.).
<p align="center">Этот текст будет по центру</p>
15. Чекбоксы
Для создания списка задач можно использовать квадратные скобки [ ]
. Отмеченные чекбоксы обозначаются как [x]
(английский икс).
- [ ] Незавершенная задача
- [x] Завершенная задача
16. Подсветка текста
Markdown не поддерживает стандартную подсветку текста, но можно использовать HTML-теги:
<span style="background-color: yellow">Подсвеченный текст</span>
Эти основные элементы помогут вам создавать форматированные документы с использованием Markdown.