Синтаксис 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.