Markdown

Markdown – легковесный язык разметки. Позволяет писать plain text, легко читаемый человеком и пригодный для преобразования в HTML, RTF и т. д.

Параграфы

Чтобы отделить параграф, оставляем после него пустую строку.

Первый параграф

Второй параграф
Продолжение второго параграфа

Перенос строки

Чтобы перенести строку внутри параграфа, ставим в конце строки два и более пробела, \ или <br>.

Перенос с помощью пробелов  
Перенос с помощью обратного слеша\
Перенос с помощью тега <br> Последняя строка

Заголовки

Заголовки начинаются с #, количество решёток определяет уровень заголовка.

# Заголовок первого уровня
## Заголовок второго уровня ##
### Заголовок третьего уровня
#### Заголовок четвёртого уровня #
##### Заголовок пятого уровня ############
###### Заголовок шестого уровня

Альтернативные методы выделения заголовков:

Заголовок первого уровня
=
Заголовок первого уровня
=========
Заголовок второго уровня
-
Заголовок второго уровня
----------

Выделение текста

*Текст курсивом*
_Текст курсивом_

**Жирный текст**
__Жирный текст__

***Текст жирным курсивом***
___Текст жирным курсивом___

~~Зачёркнутый текст~~

<u>Подчёркнутый текст</u>

Разделитель

Чтобы оформить горизонтальный разделитель, ставим три и больше *, - или _.

***
---
___
*	*  **

Цитата

>Цитата. Чтобы завершить цитату, оставляем после неё пустую строку.

> Оформление цитатой
последовательных строк
внутри одного параграфа
> # Заголовок
> Первый параграф
>
> Второй параграф
>
> > Вложенная цитата
> > > Цитата третьего уровня
>
> Продолжение основной цитаты

Списки

Нумерованный список:

1. Первый пункт
2. Второй пункт
3. Третий пункт

1. Первый пункт
2. Второй пункт
3. Третий пункт

Список можно начинать не с единицы. Между двумя списками нужно оставить две пустые строки, иначе редактор их объединит.

Ненумерованный список:

* Первый пункт
* Второй пункт
* Третий пункт
- Первый пункт
- Второй пункт
- Третий пункт
+ Первый пункт
+ Второй пункт
+ Третий пункт

Вложенные списки делаем с помощью табуляции (таб или четыре пробела).

1. Пункт
	1. Подпункт
		1. Подподпункт

- Пункт
	- Подпункт
		- Подподпункт

Чекбокс

- [x] Отмеченный пункт
- [ ] Неотмеченный пункт

Ссылки

[текст](URL “Всплывающая подсказка”)

[Example text](https://example.ru/text) без подсказки

[Example text](https://example.ru/text "Всплывающая подсказка") с подсказкой

Сноски

[текст][имя сноски] – в тексте

[имя сноски]: текст сноски – в конце текста

[Example text][1]

[Раздел «Код»][code]


[1]: https://example.ru/text "Всплывающая подсказка"
[code]: https://example.ru/code/

Изображения

![текст](URL “Всплывающая подсказка”)

![Изображение](https://upload.wikimedia.org/wikipedia/commons/thumb/4/48/Markdown-mark.svg/1920px-Markdown-mark.svg.png "Логотип Markdown")

Оформление кода

`print (x)` – внутри строки

Функция `print (x)` выводит содержимое переменной ```x```.

Чтобы оформить отдельным параграфом ставим три бэктика в начале и в конце. Если после первых трёх бэктиков указать язык (```python) редактор подсветит синтаксис.

```python
if x > 0:
	print (x)
else:
	print ('Hello, World!')
```

Таблицы

|Название столбца 1|Название столбца 2|Название столбца 3|
|:-|:-:|-:|
|Запись в столбце 1|Запись в столбце 2|Запись в столбце 3|

":" во второй строке указывает на тип выравнивания (в примере - по левому краю | по центру | по правому краю).

Для экранирования символа ставим \ перед ним.

Редакторы Markdown:

  • Caret

  • jbt.github.io/markdown-editor/

  • VS Code

Last updated