You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+26-26
Original file line number
Diff line number
Diff line change
@@ -6,21 +6,21 @@ Markdown – это облегченный язык разметки, котор
6
6
Markdown не является заменой HTML. Синтаксис Markdown достаточно ограничен, и соответствует лишь небольшому подмножеству элементов HTML. Он включает в себя следующие элементы:
7
7
8
8
1. Блочные элементы
9
-
+ Параграфы и разрывы строк;
10
-
+ Заголовки;
11
-
+ Цитаты;
12
-
+ Списки
13
-
+ Блоки кода;
14
-
+ Горизонтальные (разделительные) линии.
9
+
+[Параграфы и разрывы строк](#Parag);
10
+
+[Заголовки](#Headers);
11
+
+[Цитаты](#Blockquotes);
12
+
+[Списки](#Lists)
13
+
+[Блоки кода](#CodeBlocks);
14
+
+[Горизонтальные (разделительные) линии](#Lines).
15
15
2. Строчные элементы
16
-
+ Ссылки;
17
-
+ Выделение текста;
18
-
+Код;
19
-
+ Изображения.
16
+
+[Ссылки](#Links);
17
+
+[Выделение текста](#Emphasis);
18
+
+[Кодовые фрагменты строк](#Code);
19
+
+[Изображения](#Images).
20
20
3. Дополнительные элементы
21
-
+ Обратный слеш;
22
-
+ Автоматические ссылки;
23
-
+ Специальные символы HTML
21
+
+[Обратный слеш](#Backslash Escapes);
22
+
+[Автоматические ссылки](#Automatic Links);
23
+
+[Специальные символы HTML](#SpecialSymbol).
24
24
25
25
Более подробно с перечисленными функциями можно ознакомиться в разделе «Описание синтаксиса».
26
26
@@ -30,12 +30,12 @@ Markdown не является заменой HTML. Синтаксис Markdown
30
30
Блочные элементы
31
31
--------------------------
32
32
33
-
#####Параграфы и разрывы строк
33
+
#####<aname="Parag"></a> Параграфы и разрывы строк
34
34
Для того, чтобы создать параграф с использованием синтаксиса языка Markdown, достаточно отделить строки текста одной (или более) пустой строкой (пустой считается всякая строка, которая не содержит в себе ничего, кроме пробелов и символов табуляции).
35
35
Для того, чтобы вставить видимый перенос строки (элемент `<br/>`) необходимо окончить строку двумя пробелами и нажатием клавиши «Enter».
36
36
Многие элементы синтаксиса Markdown выглядят и работают гораздо лучше в случае, когда их форматируют с помощью «жесткого перевода строк» (разделение строк, осуществленное самим пользователем, а не программой автоматически). К таким элементам относятся цитаты, списки и пр.
37
37
38
-
##### Заголовки
38
+
##### <aname="Headers"></a> Заголовки
39
39
Язык разметки Markdown поддерживает 2 стиля обозначения заголовков: подчеркивание и выделение символом («#»).
40
40
Выделение заголовков с помощью подчеркивания производится знаками равенства («=») в случае, если заголовок первого уровня, и дефисами («-») в случае, если заголовок второго уровня. Количество знаков подчеркивания не ограничивается.
41
41
При выделении заголовков с помощью символа («#») используется от одного до шести данных символов, которые устанавливаются в начале строки (перед заголовком). В данном случае количество символов соответствует уровню заголовка. Кроме того, заголовок возможно снабдить закрывающимися символами («#»), хотя это и не является обязательным. Количество закрывающихся символов не обязано соответствовать количеству начальных символов. Уровень заголовка определяется по количеству начальных символов.
@@ -68,7 +68,7 @@ Markdown не является заменой HTML. Синтаксис Markdown
68
68
### Заголовок третьего уровня
69
69
###### Заголовок шестого уровня
70
70
71
-
##### Цитаты
71
+
##### <aname="Blockquotes"></a> Цитаты
72
72
Для обозначения цитат в языке Markdown используется знак «больше» («>»). Его можно вставлять как перед каждой строкой цитаты, так и только перед первой строкой параграфа.
73
73
Также синтаксис Markdown позволяет создавать вложенные цитаты (цитаты внутри цитат). Для их разметки используются дополнительные уровни знаков цитирования («>»).
74
74
Цитаты в Markdown могут содержать всевозможные элементы разметки.
@@ -113,7 +113,7 @@ Markdown не является заменой HTML. Синтаксис Markdown
113
113
114
114
Уровень цитирования не может превышать 15-й.
115
115
116
-
##### Списки
116
+
##### <aname="Lists"></a> Списки
117
117
Markdown поддерживает упорядоченные (нумерованные) и неупорядоченные (ненумерованные) списки.
118
118
Для формирования неупорядоченный списков используются такие маркеры, как звездочки, плюсы и дефисы. Все перечисленные маркеры могут использоваться взаимозаменяемо.
119
119
Для формирования упорядоченных списков в качестве маркеров используются числа с точкой. Важной особенностью в данном случае является то, что сами номера, с помощью которых формируется список, не важны, так как они не оказывают влияния на выходной HTML код. Как бы ни нумеровал пользователь список, на выходе он в любом случае будет иметь упорядоченный список, начинающийся с единицы (1, 2, 3…). Эту особенность стоит учитывать в том случае, когда необходимо использовать порядковые номера элементов в списке, чтобы они соответствовали номерам, получающимся в HTML.
@@ -181,7 +181,7 @@ Markdown поддерживает упорядоченные (нумерован
181
181
182
182
<исходный код >
183
183
184
-
##### Блоки кода
184
+
##### <aname="CodeBlocks"></a> Блоки кода
185
185
Отформатированные блоки кода используются в случае необходимости процитировать исходный код программ или разметки.
186
186
Для создания блока кода в языке Markdown необходимо каждую строку параграфа начинать с отступа, состоящего из четырех пробелов или одного символа табуляции. Блок кода продолжается до тех пор, пока не встретится строка без отступа (или конец текста). Внутри блока кода амперсанды («&») и угловые скобки («<» и «>») автоматически преобразуются в элементы HTML разметки. Кроме того, следует отметить, что внутри блоков кода обычный синтаксис Markdown не обрабатывается.
187
187
Блок кода в Markdown выглядит следующим образом:
@@ -190,7 +190,7 @@ Markdown поддерживает упорядоченные (нумерован
190
190
191
191
Это блок кода
192
192
193
-
##### Горизонтальные линии (разделители)
193
+
##### <aname="Lines"> </a> Горизонтальные линии (разделители)
194
194
195
195
Для того чтобы создать горизонтальную линию с использованием синтаксиса языка Markdown, необходимо поместить три (или более)дефиса или звездочки на отдельной строке текста. Между ними возможно располагать пробелы.
196
196
Горизонтальные линии в Markdown выглядят следующим образом:
@@ -217,7 +217,7 @@ Markdown поддерживает упорядоченные (нумерован
217
217
Строчные элементы
218
218
-------------------
219
219
220
-
##### Ссылки
220
+
##### <aname="Links"></a> Ссылки
221
221
Markdown поддерживает два стиля оформления ссылок:
222
222
223
223
- Гиперссылка, с немедленным указанием адреса (внутритекстовая);
@@ -268,7 +268,7 @@ Markdown позволяет также использовать неявно в
268
268
[Example][]
269
269
[Example]: http://example.com/
270
270
271
-
##### Выделение текста
271
+
##### <aname="Emphasis"></a> Выделение текста
272
272
Markdown воспринимает звёздочки «*» и символы подчёркивания «_» как признаки смыслового выделения текста:
273
273
274
274
- Текст, окружённый одиночными «*» или «_», будет заключен в HTML-тэг `<em>`.
Чтобы отметить фрагмент строки, содержащий код, необходимо окружить его обратными апострофами «`». При использовании кодовых фрагментов строк текст будет отображаться в виде моноширинного шрифта.
306
306
В отличие от блоков кода, кодовый фрагмент позволяет поместить код внутрь обычного абзаца текста.
307
307
Кодовый фрагмент строки в языке Markdown выглядит следующим образом:
308
308
309
309
Используйте оператор `if`
310
310
311
-
##### Изображения
311
+
##### <aname="Images"></a> Изображения
312
312
В Markdown существует 2 способа вставки изображений в документ:
313
313
314
314
a. С помощью непосредственного указания URL-адреса изображения. Синтаксис данной команды выглядит следующим образом:
@@ -334,7 +334,7 @@ b. С помощью метки-идентификатора. Синтакси
Может употребляться в Markdown перед специальными символами для того, чтобы они воспринимались в их буквальном (а не служебном) значении. Полный список данных символов приводится ниже:
339
339
340
340
«\» - слеш;
@@ -361,7 +361,7 @@ b. С помощью метки-идентификатора. Синтакси
Markdown поддерживает упрощённый порядок автоматического создания ссылок для URL-адресов и адресов электронной почты. Для этого достаточно поместить URL-адрес или почтовый адрес в угловые скобки, и Markdown сделает его гиперссылкой. В отличие от вышеописанных стилей, в данном случае сам же URL-адрес или почтовый адрес становится и текстом гиперссылки. Автоматические ссылки на адреса электронной почты работают аналогично.
366
366
Автоматические ссылки в языке Markdown выглядят следующим образом
367
367
@@ -375,7 +375,7 @@ Markdown поддерживает упрощённый порядок автом
##### <aname="SpecialSymbol"></a> Специальные символы HTML
379
379
В языке HTML существует два символа, требующих специального рассмотрения: это символы («<») и («&»). Левая угловая скобка используется как начало тэга; амперсанды применяются для обозначения специального символа HTML.
380
380
Для того чтобы использовать эти символы в их буквальном смысле, необходимо заменить их элементами HTML, а именно `<` и `&` соответственно.
381
381
При использовании Markdown подобных действий совершать не нужно. Он позволяет использовать эти символы в исходном виде. В случае если амперсанд используется как часть спецсимвола HTML, он останется неизменным. В противном случае Markdown преобразует его в `&`.
0 commit comments