Справочник по языку разметки Markdown

HTML в Markdown ↑top↑

В большинстве редакторов Markdown можно использовать HTML-теги для дополнительного форматирования текста или вставки специфических элементов, если стандартный синтаксис Markdown не предоставляет нужной функциональности. Однако это может быть не совсем удобно и не совсем соответствует цели использования Markdown, которая заключается в создании простого и легко читаемого форматированного текста без необходимости использования HTML.

Пример:

Cut:
<kbd>CTRL</kbd> + <kbd>X</kbd>

Copy:
<kbd>CTRL</kbd> + <kbd>C</kbd>

Paste:
<kbd>CTRL</kbd> + <kbd>V</kbd>

Save:
<kbd>CTRL</kbd> + <kbd>S</kbd>

Результат:

Cut: CTRL + X

Copy: CTRL + C

Paste: CTRL + V

Save: CTRL + S

Параграфы и разрывы строк (Paragraphs and line breaks) ↑top↑

Чтобы поделить текст на параграфы, между ними нужно оставить пустую строку. Строка считается пустой, даже если в ней есть пробелы и табуляции. Если же строки находятся рядом, то они автоматически склеиваются в одну.

Пример:

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

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

Результат:

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

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

Для переноса строки внутри одного параграфа есть три метода:

поставить в конце строки два или больше пробела
поставить в конце строки обратную косую черту \
использовать HTML-тег <br>

Пример:

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

Результат:

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

Обратите внимание, что у каждого из методов есть свои недостатки:

пробелы в конце строки бывает трудно заметить, и это может запутать читателя
обратный слеш вводится в стандарте CommonMark и может поддерживаться не всеми редакторами
HTML-теги в Markdown также поддерживаются не всеми редакторами

Заголовки (Headings) ↑top↑

В синтаксисе Markdown есть шесть уровней заголовков: от H1 (самого большого) до H6 (самого маленького). Для их выделения используют решётки #, при этом есть несколько тонкостей:

решётки можно ставить как перед заголовком, так и с двух сторон от него (на уровень заголовка влияют только те #, которые находятся перед ним)
количество решёток соответствует уровню заголовка: одна для первого уровня, две для второго и так далее
между решёткой и текстом ставится пробел

Пример:

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

Результат:

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

Заголовок второго уровня

Заголовок третьего уровня

Заголовок четвёртого уровня

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

Заголовок шестого уровня

С помощью HTML заголовки записываются в тегах от <h1> (самого большого) до <h6> (самого маленького):

Пример:

<h1>Заголовок первого уровня</h1>
<h2>Заголовок второго уровня</h2>
<h3>Заголовок третьего уровня</h3>
<h4>Заголовок четвёртого уровня</h4>
<h5>Заголовок пятого уровня</h5>
<h6>Заголовок шестого уровня</h6>

Результат:

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

Заголовок второго уровня

Заголовок третьего уровня

Заголовок четвёртого уровня

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

Заголовок шестого уровня

У заголовков первого и второго уровня есть альтернативный способ выделения: на следующей строке после них нужно поставить знаки равенства = или дефисы -. Вот несколько правил:

знак = применяется для заголовков H1
дефис применяется для заголовков H2
если в одной строке поставить оба знака, то работать ничего не будет
можно ставить любое количество знаков, и на тип заголовка это не повлияет
между заголовком и знаками не должно быть пустых строк

Пример:

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

Результат:

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

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

Заголовок второго уровня

Заголовок второго уровня

Выделение текста (Emphasis) ↑top↑

Чтобы изменить начертание текста, нужно выделить его с двух сторон спецсимволами следующим образом: <спецсимвол>текст<спецсимвол>.

Курсив (Italic) ↑top↑

Для выделения текста курсивом нужно использовать одну звёздочку * или нижнее подчёркивание _.

Пример:

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

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

Результат:

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

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

Так же это можно сделать через HTML теги:

Пример:

<i>Текст курсивом</i>

<em>Текст курсивом</em>

Результат:

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

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

Жирный (Bold) ↑top↑

Для выделения текста жирным нужно использовать две звёздочки ** или два нижних подчёркивания __.

Пример:

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

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

Результат:

Жирный текст

Жирный текст

Так же это можно сделать через HTML теги:

Пример:

<b>Жирный текст</b>

<strong>Жирный текст</strong>

Результат:

Жирный текст

Жирный текст

Жирный курсив (Bold and italic) ↑top↑

Для выделения текста сразу обоими стилями нужно использовать три звёздочки *** или три нижних подчёркивания ___.

Пример:

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

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

Результат:

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

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

Так же это можно сделать через HTML теги:

Пример:

<i><b>Текст жирным курсивом</b></i>

<em><strong>Текст жирным курсивом</strong></em>

<i><strong>Текст жирным курсивом</strong></i>

<em><b>Текст жирным курсивом</b></em>

Результат:

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

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

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

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

Обратите внимание, что если вы хотите выделить фрагмент внутри слова, то это корректно сработает только при использовании звёздочек.

Пример:

Кор*рек*тно, кор**рек**тно, кор***рек***тно

Кор<i>рек</i>тно, кор<b>рек</b>тно, кор<i><b>рек</b></i>тно, кор<i><b>рек</i></b>тно

Некор_рек_тно, некор__рек__тно, некор___рек___тно

Результат:

Корректно, корректно, корректно

Корректно, корректно, корректно, корректно

Некор_рек_тно, некор__рек__тно, некор___рек___тно

Зачёркнутый (Strikethrough) ↑top↑

Чтобы зачеркнуть текст, нужно использовать две тильды ~~ или одна ~. Такая опция есть только в диалекте GitHub Flavored Markdown.

Пример:

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

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

Результат:

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

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

Так же это можно сделать через HTML теги:

Пример:

<strike>Зачёркнутый текст</strike>

<del>Зачёркнутый текст</del>

Результат:

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

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

Подчёркнутый (Underline) ↑top↑

В синтаксисе Markdown нет встроенного способа подчеркнуть текст. Но если ваш редактор поддерживает HTML, то можно использовать теги:

Пример:

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

Результат:

Подчёркнутый текст

Разделители (Horizontal rules) ↑top↑

Чтобы оформить горизонтальный разделитель, нужно поставить три или больше специальных символа: звёздочки *, дефиса - или нижних подчёркивания _. Они должны находиться на отдельной строке, и между ними можно ставить любое количество пробелов и табуляций.

Если ваш редактор поддерживает HTML-теги, то для разметки можно также использовать тег <hr>.

Пример:

***
---
___
*	*  **
<hr>

Результат:

Цитаты (Blockquotes) ↑top↑

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

Пример:

Нецитатный текст
> Оформление цитатой
последовательных строк
внутри одного параграфа

Нецитатный текст

Результат:

Нецитатный текст

Оформление цитатой последовательных строк внутри одного параграфа

Нецитатный текст

Внутрь одного блока цитаты можно поместить сразу несколько параграфов и использовать любые элементы оформления. Например, заголовки и другие цитаты. Чтобы сделать это, нужно поместить закрывающую угловую скобку перед началом каждой строки.

Пример:

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

Результат:

Заголовок

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

Второй параграф

Вложенная цитата

Цитата третьего уровня

Продолжение основной цитаты

Так же это можно сделать через HTML теги:

Пример:

<blockquote>
    Это цитата с использованием HTML в Markdown.
</blockquote>

Результат:

Это цитата с использованием HTML в Markdown.

Спойлер (Spoiler) ↑top↑

Если после символа цитирования поставить восклицательный знак >!, то цитата выведется свёрнутой, и развернуть её пользователь сможет, кликнув по ней.

Пример:

Предупреждение о спойлере
>!Текст спойлера

Результат:

Предупреждение о спойлере

!Текст спойлера

Так же это можно сделать через HTML теги:

Пример:

<details>
    <summary>Предупреждение о спойлере</summary>
    Текст спойлера
</details>

Результат:

Предупреждение о спойлере
Текст спойлера

Списки (Lists) ↑top↑

В синтаксисе Markdown есть несколько видов списков. Для их оформления перед каждым пунктом нужно поставить подходящий тег и отделить его от текста пробелом.

Нумерованные (Ordered) ↑top↑

Для создания нумерованного списка перед пунктами нужно поставить число с точкой. При этом нумерация в разметке ленивая. Неважно, какие именно числа вы напишете: Markdown пронумерует список автоматически.

Пример:

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



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



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

Результат:

Первый пункт

Второй пункт

Третий пункт

Первый пункт

Второй пункт

Третий пункт

Первый пункт

Второй пункт

Третий пункт

Список можно начинать и не с единицы. Для нумерации важно только число, которое стоит перед первым пунктом.

Пример:

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

Результат:

Первый пункт

Второй пункт

Третий пункт

Обратите внимание, что между двумя нумерованными списками, идущими подряд, нужно отбить две пустые строки. Если отбить только одну или две, то Markdown воспримет два списка как один. Некоторые редакторы в таком случае увеличивают интервал между пунктами.

Пример:

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

1. Четвёртый пункт
2. Пятый пункт
3. Шестой пункт


1. Седмой пункт
2. Восьмой пункт
3. Девятый пункт

Результат:

Первый пункт

Второй пункт

Третий пункт

Четвёртый пункт

Пятый пункт

Шестой пункт

Седмой пункт

Восьмой пункт

Девятый пункт

Так же это можно сделать через HTML теги:

Пример:

<ol>
    <li>Первый пункт</li>
    <li>Второй пункт</li>
    <li>Третий пункт</li>
</ol>

Результат:

Первый пункт

Второй пункт

Третий пункт

Тег <ol> означает order list.

Ненумерованные (Unordered) ↑top↑

Для создания ненумерованного списка нужно поставить перед каждым пунктом звёздочку *, дефис - или плюс +.

Пример:

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

Результат:

Первый пункт

Второй пункт

Третий пункт

Первый пункт

Второй пункт

Третий пункт

Первый пункт

Второй пункт

Третий пункт

Обратите внимание, что Markdown относит к разным спискам пункты, перед которыми стоят разные маркеры. Даже несмотря на то, что мы не оставляем пустых строк между списками.

Если же два списка идут подряд, а перед их пунктами стоят одинаковые маркеры, тогда между ними нужно отбить две пустые строки (как в случае с нумерованными списками).

Так же это можно сделать через HTML теги:

Пример:

<ul>
    <li>Первый пункт</li>
    <li>Второй пункт</li>
    <li>Третий пункт</li>
</ul>

Результат:

Первый пункт

Второй пункт

Третий пункт

Тег <ul> означает unorder list.

Чекбоксы (Checkboxes) ↑top↑

Чтобы сделать чекбоксы, нужно использовать маркированный список, но между маркером и текстом поставить [x] для отмеченного пункта и [ ] — для неотмеченного.

Чекбоксы доступны в диалекте GitHub Flavored Markdown (тот самый, который умеет зачёркивать текст) и поддерживаются не всеми редакторами Markdown. Например, нам для демонстрации примера пришлось открывать другой.

Пример:

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

Результат:

Отмеченный пункт

Неотмеченный пункт

Вложенные (Nested) ↑top↑

Чтобы создать вложенный список, нужно поставить перед его пунктами табуляцию или несколько пробелов. В Markdown одна табуляция соответствует четырём пробелам.

Список одного вида можно вкладывать в любой другой.

Пример:

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

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


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

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

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

Результат:

Пункт

Подпункт

Подподпункт

Пункт

Подпункт

Подподпункт

Пункт

Подпункт

Подподпункт

Пункт

Подпункт

Пункт

Отмеченный подпункт

Неотмеченный подпункт

Подподпункт

На самом деле количество пробелов, которые нужно поставить для корректного отступа, рассчитывается чуть сложнее. Берётся количество символов в маркере (один для *, - и +, два для 1., три для 10.), и к нему прибавляется любое число от 1 до 4.

Таким образом, если в маркере 1 символ, нужно поставить от 2 до 5 пробелов, если 2 символа — от 3 до 6, если 3 символа — от 4 до 7.

Так же это можно сделать через HTML теги:

Пример:

<ul>
    <li>Пункт 1</li>
    <ul>
        <li>Подподпункт 1.1</li>
        <li>Подподпункт 1.2</li>
    </ul>
    <li>Пункт 2</li>
</ul>

Результат:

Пункт 1

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

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

Пункт 2

Другие элементы внутри списков (Other) ↑top↑

В пункты списков можно добавлять другие элементы оформления. Например, параграфы или цитаты. Для этого нужно сделать отступ, как если бы вы добавляли вложенный список.

Пример:

1. Первый пункт
	> Цитата внутри первого пункта
1. Второй пункт
 	
    Параграф внутри второго пункта
1. Третий пункт

Результат:

Первый пункт

Цитата внутри первого пункта

Второй пункт

Параграф внутри второго пункта

Третий пункт

Так же это можно сделать через HTML теги:

Пример:

<ul>
    <li>Пункт 1</li>
    <blockquote>
        Цитата внутри первого пункта
    </blockquote>
    <li>Пункт 2</li>
    <p>
        Параграф внутри второго пункта
    </p>
    <li>Пункт 3</li>
</ul>

Результат:

Пункт 1

Цитата внутри первого пункта

Пункт 2

Параграф внутри второго пункта

Пункт 3

Ссылки (Links) ↑top↑

Markdown предлагает 3 стиля разметки ссылок: строчный, справочный и автоматический.

Строчные (Inline) ↑top↑

Чтобы оформить ссылкой часть текста, используется такой синтаксис: [текст](ссылка). Можно сделать всплывающую подсказку при наведении курсора. Для этого в круглых скобках после ссылки нужно поставить пробел и написать текст подсказки в кавычках [текст](ссылка "подсказка").

Пример:

[GitHub Account](https://github.com/BogdanKlimov11) без подсказки

[GitHub Account](https://github.com/BogdanKlimov11 "Всплывающая подсказка") с подсказкой

Результат:

GitHub Account без подсказки

GitHub Account с подсказкой

Справочные (Help) ↑top↑

Ещё один способ оформить ссылку — справочный. Он работает как сноски в книгах: [текст][имя сноски]. При таком способе организации ссылок в конце документа нужно также написать и оформить саму сноску: [имя сноски]: ссылка. При желании после ссылки можно добавить подсказку — точно так же, как в предыдущем методе.

Имя сноски может быть любым сочетанием символов: цифрами, буквами и даже знаками препинания. На одну и ту же сноску в тексте можно ссылаться сколько угодно раз.

Ссылки, оформленные справочным методом, выглядят и работают точно так же, как и в предыдущем способе. Сами сноски в отформатированном документе не отображаются.

Пример:

[Без подсказки][1]

[С подсказкой][2]

[Раздел «Repositories»][repo]



[1]: https://github.com/BogdanKlimov11

[2]: https://github.com/BogdanKlimov11 "Всплывающая подсказка"

[repo]: https://github.com/BogdanKlimov11?tab=repositories

Результат:

Без подсказки

С подсказкой

Раздел «Repositories»

Автоматические (Automatic) ↑top↑

Markdown позволяет использовать упрощённый вариант для вставки ссылок, для этого нужно просто обернуть ссылку треугольными скобками <ссылка>.

Можно вставлять адреса электронной почты <email>, тогда мы автоматически получим ссылку типа mailto:.

Несмотря на простоту, он не является основным и был добавлен только в спецификации CommonMark.

Пример:

<https://github.com/BogdanKlimov11>

<[email protected]>

Результат:

https://github.com/BogdanKlimov11

[email protected]

Так же это можно сделать через HTML теги:

Пример:

Без подсказки
<a href="https://github.com/BogdanKlimov11">GitHub Account</a>

С подсказкой
<a href="https://github.com/BogdanKlimov11" title="Всплывающая подсказка">GitHub Account</a>

Результат:

Без подсказки GitHub Account

С подсказкой GitHub Account

Картинки (Images) ↑top↑

Конструкции для вставки изображений очень похожи на те, что используются для ссылок. Предлагается 2 стиля разметки: строчный и справочный.

Строчные (Inline) ↑top↑

Изображения в Markdown оформляются по принципу, схожему с принципом оформления ссылкок, только перед квадратными скобками нужно поставить восклицательный знак: ![текст](путь к изображению). Здесь также можно сделать всплывающую подсказку ![текст](путь к изображению "подсказка").

Пример:

Без подсказки
![Novosibirsk Technopark](https://github.com/BogdanKlimov11/Markdown_course/assets/136115919/1edd6030-a0f6-43ac-ad44-e06cdedcd763)

С подсказкой
![Picture of NSU](https://github.com/BogdanKlimov11/Markdown_course/assets/136115919/3bd514d0-e83f-4738-91d4-5f693777f90b "NSU")

Результат:

Без подсказки

С подсказкой

Справочные (Help) ↑top↑

Можно использовать и справочный метод: ![текст][имя сноски]. Сноски оформляются так же, как и в ссылках: [имя сноски]: путь к изображению, — в них тоже можно добавлять подсказки [имя сноски]: путь к изображению "подсказка".

Пример:

Без подсказки
![Opera and Ballet Theatre][image1]

С подсказкой
![Flotilia][image2]



[image1]: https://github.com/BogdanKlimov11/Markdown_course/assets/136115919/7fbd1f5d-cf25-4888-a900-e6f33f6b6bda

[image2]: https://github.com/BogdanKlimov11/Markdown_course/assets/136115919/0264b60c-4c49-4ead-affa-4db4dc2e606e "Residential complex"

Результат:

Без подсказки

С подсказкой

Так же это можно сделать через HTML теги:

Пример:

Без подсказки

<img src="https://github.com/BogdanKlimov11/Markdown_course/assets/136115919/696d22ce-38d7-4c2f-9391-d5a1ef63cd16" alt="Novosibirsk Arena">

С подсказкой

<img src="https://github.com/BogdanKlimov11/Markdown_course/assets/136115919/ce26d88f-ca37-4c64-8627-0f237b6ab35d" alt="Bugrinsky Bridge" title="Bridge">

Результат:

Без подсказки

С подсказкой

Вставка кода (Code) ↑top↑

В Markdown есть несколько способов выделить исходный код:

если надо отобразить фрагмент кода внутри строки с каким-то текстом, нужно с двух сторон выделить этот код одним или несколькими обратными апострофами ``` (их ещё называют бэктиками).
чтобы выделить фрагмент из нескольких строк, нужно с двух сторон выделить его тремя обратными апострофами.
также перед фрагментом кода можно поставить табуляцию или четыре пробела, при этом предыдущая строка должна быть пустой.

Одна-две пары бэктиков (One or two pairs of backticks) ↑top↑

Пример:

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

Результат:

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

Три и более пары бэктиков (Three or more pairs of backticks) ↑top↑

Пример:

```

#include <stdio.h>

int main() {

printf("Hello, World!");

return 0;

}

```

Результат:

#include <stdio.h>
int main() {
    printf("Hello, World!");
    return 0;
}

Отступ (Indentation) ↑top↑

Пример:

let x = 12;
let y = 6;
console.log(x + y);

Результат:

let x = 12;
let y = 6;
console.log(x + y);

Подсветка кода (Code highlighting) ↑top↑

Если обрамлять код тремя обратными апострофами, то после первой тройки можно указать язык программирования — тогда Markdown правильно подсветит элементы кода.

Пример:

```python

if x > 0:

print (x)

else:

print ('Hello, World!')

```

```c

#include <stdio.h>

int main() {

printf("Hello, World!");

return 0;

}

```

```javascript

let x = 12;

let y = 6;

console.log(x + y);

```

Результат:

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

#include <stdio.h>
int main() {
   printf("Hello, World!");
   return 0;
}

let x = 12;
let y = 6;
console.log(x + y);

Возможность вставлять блоки кода тремя обратными апострофами появилась в спецификации CommonMark, но там не указан список псевдонимов: как правильно называть языки, чтобы Markdown понял, о чём речь.

Поэтому каждая реализация ведёт свой собственный список языков и их псевдонимов. Так как их очень много, да ещё и новые время от времени добавляются, то удобных таблиц обычно не делают. Предлагают сразу ознакомиться с конфигурационным файлом.

Вот такой список языков, например, поддерживает диалект GitHub Flavored Markdown.

Таблицы (Tables) ↑top↑

В уже упомянутом выше диалекте GitHub Flavored Markdown (и некоторых других тоже) есть возможность оформлять таблицы. Столбцы разделяются вертикальными линиями |, а строка с шапкой отделяется от остальных дефисами -, которых можно ставить сколько угодно.

Пример:

|Столбец 1|Столбец 2|Столбец 3|
|-|--------|---|
|Длинная запись в первом столбце|Запись в столбце 2|Запись в столбце 3|
|Кртк зпс| |Слева нет записи|

Результат:

Столбец 1 Столбец 2 Столбец 3

Длинная запись в первом столбце Запись в столбце 2 Запись в столбце 3

Кртк зпс Слева нет записи

Чтобы выровнять весь столбец по правому краю, в строке с дефисами сразу после дефисов можно поставить двоеточие :. Чтобы выровнять содержимое по центру, надо поставить двоеточия с обеих сторон.

Пример:

|Столбец 1|Столбец 2|Столбец 3|
|:-|:-:|-:|
|Равнение по левому краю|Равнение по центру|Равнение по правому краю|
|Запись|Запись|Запись|

Результат:

Столбец 1 Столбец 2 Столбец 3

Равнение по левому краю Равнение по центру Равнение по правому краю

Запись Запись Запись

Так же это можно сделать через HTML теги:

Пример:

<table border="1">
    <tr>
        <th>Заголовок 1</th>
        <th>Заголовок 2</th>
    </tr>
    <tr>
        <td>Ячейка 1</td>
        <td>Ячейка 2</td>
    </tr>
</table>

Результат:

Заголовок 1 Заголовок 2

Ячейка 1 Ячейка 2

Экранирование (Escaping characters) ↑top↑

Многие символы в Markdown выполняют роль служебных. Если они встречаются в вашем тексте сами по себе, то для корректного отображения их стоит экранировать (иначе они просто не только не отобразятся сами, но и добавят вашему тексту какое-нибудь ненужное форматирование). Для этого перед ними ставится обратная косая черта \.

Вот список символов, которые нужно экранировать: *_{}[]<>()#+-.! |\. Делать это постоянно необязательно — достаточно ставить экран только в тех случаях, когда Markdown может воспринять эти символы как служебные. Например, если строка начинается с символа #, то экранировать её надо — потому что программа может решить, что вы хотите сделать заголовок. А вот если решётка находится где-то в центре строки, то экранировать ничего не надо — редактор поймёт, что тут она просто часть текста.

Как использовать Markdown в мессенджерах ↑top↑

Как мы уже писали, принципы Markdown используются при разметке текста во многих мессенджерах. Обычно он используется для выделения текста, при этом синтаксис у каждой платформы свой.

Жирный:
- Telegram и Discord — **две звёздочки с двух сторон**
- WhatsApp и Viber — *одна звёздочка с двух сторон*
Курсив:
- Telegram — __два нижних подчёркивания с двух сторон__
- WhatsApp и Viber — _одно нижнее подчёркивание с двух сторон_
- Discord — *одна звёздочка с двух сторон* или _одно нижнее подчёркивание с двух сторон_
Подчёркнутый:
- Discord — __два нижних подчёркивания с двух сторон__
Зачёркнутый:
- WhatsApp и Viber — ~одна тильда с двух сторон~
- Discord — ~~две тильды с двух сторон~~
Моноширинный (используется для вставки кода):
- Telegram, WhatsApp, Viber и Discord — ```три обратных апострофа с двух сторон```
- в Discord точно так же, как и в Markdown, можно указывать язык программирования для подсветки синтаксиса
Спойлер:
- Telegram и Discord — ||две вертикальные черты с двух сторон||

Эмодзи (Emoji) ↑top↑

Запись в файл (Write to file) ↑top↑

Для вывода эмодзи в Markdown вы можете использовать скопированные эмодзи (т. е. вставить в файл прямо как символ), Unicode-символы или встроенные эмодзи.

Вывод для Unicode-символов в HTML выглядит следующим образом: &#xкод; - 16-чный или &#код; - 10-чный.

Пример:

Смайлик: 😊

&#128522; - в 10-чной

&#x1F60A; - в 16-чной

Результат:

Смайлик: 😊

😊 - в 10-чной

😊 - в 16-чной

Вывод встроенных эмодзи выглядит так: :название эмодзи:.

Пример:

Смайлик: 😊

:blush:

Результат:

Смайлик: 😊

😊

Общий список (Common list) ↑top↑

Список всех эмодзи сожно посмотреть здесь.

Формулы LaTex (Formulas) ↑top↑

Запись в файл (Write to file) ↑top↑

Для использования формул LaTeX в Markdown можно использовать специальные символы и синтаксис, который будет интерпретироваться Markdown-парсером.

Встроенные формулы: Вы можете использовать одинарные долларовые знаки $ или структуру $формула$ для встроенных формул.
Блочные формулы: Для более сложных формул, которые должны быть отдельными от текста, вы можете использовать двойные долларовые знаки $$ или структуру \[формула\]. Так же перед формулой должна быть пустая строка.

Пример:

встроенная формула $E=mc^2$

блочная формула

$$
\int_{-\infty}^{\infty} e^{-x^2} \, dx = \sqrt{\pi}
$$

Результат:

встроенная формула $E=mc^2$

блочная формула

$$ \int_{-\infty}^{\infty} e^{-x^2} , dx = \sqrt{\pi} $$

Общий список (Common list) ↑top↑

Элементы LaTex можно взять здесь.

Name		Name	Last commit message	Last commit date
Latest commit History 44 Commits
README.md		README.md

Столбец 1	Столбец 2	Столбец 3
Длинная запись в первом столбце	Запись в столбце 2	Запись в столбце 3
Кртк зпс		Слева нет записи

Столбец 1	Столбец 2	Столбец 3
Равнение по левому краю	Равнение по центру	Равнение по правому краю
Запись	Запись	Запись

BogdanKlimov11/Markdown_course

Folders and files

Latest commit

History

Repository files navigation

Справочник по языку разметки Markdown

Оглавление

HTML в Markdown ↑top↑

Пример:

Результат:

Параграфы и разрывы строк (Paragraphs and line breaks) ↑top↑

Пример:

Результат:

Пример:

Результат:

Заголовки (Headings) ↑top↑

Пример:

Результат:

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

Заголовок второго уровня

Заголовок третьего уровня

Заголовок четвёртого уровня

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

Заголовок шестого уровня

Пример:

Результат:

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

Заголовок второго уровня

Заголовок третьего уровня

Заголовок четвёртого уровня

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

Заголовок шестого уровня

Пример:

Результат:

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

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

Заголовок второго уровня

Заголовок второго уровня

Выделение текста (Emphasis) ↑top↑

Курсив (Italic) ↑top↑

Пример:

Результат:

Пример:

Результат:

Жирный (Bold) ↑top↑

Пример:

Результат:

Пример:

Результат:

Жирный курсив (Bold and italic) ↑top↑

Пример:

Результат:

Пример:

Результат:

Пример:

Результат:

Зачёркнутый (Strikethrough) ↑top↑

Пример:

Результат:

Пример:

Результат:

Подчёркнутый (Underline) ↑top↑

Пример:

Результат:

Разделители (Horizontal rules) ↑top↑

Пример:

Результат:

Цитаты (Blockquotes) ↑top↑

Пример:

Результат:

Пример:

Результат:

Заголовок

Пример:

Результат:

Спойлер (Spoiler) ↑top↑

Пример:

Результат:

Пример:

Результат: