Skip to content

Commit ca73a30

Browse files
committed
Anchos
1 parent db9f9cf commit ca73a30

File tree

1 file changed

+26
-26
lines changed

1 file changed

+26
-26
lines changed

README.md

+26-26
Original file line numberDiff line numberDiff line change
@@ -6,21 +6,21 @@ Markdown – это облегченный язык разметки, котор
66
Markdown не является заменой HTML. Синтаксис Markdown достаточно ограничен, и соответствует лишь небольшому подмножеству элементов HTML. Он включает в себя следующие элементы:
77

88
1. Блочные элементы
9-
+ Параграфы и разрывы строк;
10-
+ Заголовки;
11-
+ Цитаты;
12-
+ Списки
13-
+ Блоки кода;
14-
+ Горизонтальные (разделительные) линии.
9+
+ [Параграфы и разрывы строк](#Parag);
10+
+ [Заголовки](#Headers);
11+
+ [Цитаты](#Blockquotes);
12+
+ [Списки](#Lists)
13+
+ [Блоки кода](#CodeBlocks);
14+
+ [Горизонтальные (разделительные) линии](#Lines).
1515
2. Строчные элементы
16-
+ Ссылки;
17-
+ Выделение текста;
18-
+ Код;
19-
+ Изображения.
16+
+ [Ссылки](#Links);
17+
+ [Выделение текста](#Emphasis);
18+
+ [Кодовые фрагменты строк](#Code);
19+
+ [Изображения](#Images).
2020
3. Дополнительные элементы
21-
+ Обратный слеш;
22-
+ Автоматические ссылки;
23-
+ Специальные символы HTML
21+
+ [Обратный слеш](#Backslash Escapes);
22+
+ [Автоматические ссылки](#Automatic Links);
23+
+ [Специальные символы HTML](#SpecialSymbol).
2424

2525
Более подробно с перечисленными функциями можно ознакомиться в разделе «Описание синтаксиса».
2626

@@ -30,12 +30,12 @@ Markdown не является заменой HTML. Синтаксис Markdown
3030
Блочные элементы
3131
--------------------------
3232

33-
#####Параграфы и разрывы строк
33+
##### <a name="Parag"></a> Параграфы и разрывы строк
3434
Для того, чтобы создать параграф с использованием синтаксиса языка Markdown, достаточно отделить строки текста одной (или более) пустой строкой (пустой считается всякая строка, которая не содержит в себе ничего, кроме пробелов и символов табуляции).
3535
Для того, чтобы вставить видимый перенос строки (элемент `<br/>`) необходимо окончить строку двумя пробелами и нажатием клавиши «Enter».
3636
Многие элементы синтаксиса Markdown выглядят и работают гораздо лучше в случае, когда их форматируют с помощью «жесткого перевода строк» (разделение строк, осуществленное самим пользователем, а не программой автоматически). К таким элементам относятся цитаты, списки и пр.
3737

38-
##### Заголовки
38+
##### <a name="Headers"></a> Заголовки
3939
Язык разметки Markdown поддерживает 2 стиля обозначения заголовков: подчеркивание и выделение символом («#»).
4040
Выделение заголовков с помощью подчеркивания производится знаками равенства («=») в случае, если заголовок первого уровня, и дефисами («-») в случае, если заголовок второго уровня. Количество знаков подчеркивания не ограничивается.
4141
При выделении заголовков с помощью символа («#») используется от одного до шести данных символов, которые устанавливаются в начале строки (перед заголовком). В данном случае количество символов соответствует уровню заголовка. Кроме того, заголовок возможно снабдить закрывающимися символами («#»), хотя это и не является обязательным. Количество закрывающихся символов не обязано соответствовать количеству начальных символов. Уровень заголовка определяется по количеству начальных символов.
@@ -68,7 +68,7 @@ Markdown не является заменой HTML. Синтаксис Markdown
6868
### Заголовок третьего уровня
6969
###### Заголовок шестого уровня
7070

71-
##### Цитаты
71+
##### <a name="Blockquotes"></a> Цитаты
7272
Для обозначения цитат в языке Markdown используется знак «больше» («>»). Его можно вставлять как перед каждой строкой цитаты, так и только перед первой строкой параграфа.
7373
Также синтаксис Markdown позволяет создавать вложенные цитаты (цитаты внутри цитат). Для их разметки используются дополнительные уровни знаков цитирования («>»).
7474
Цитаты в Markdown могут содержать всевозможные элементы разметки.
@@ -113,7 +113,7 @@ Markdown не является заменой HTML. Синтаксис Markdown
113113

114114
Уровень цитирования не может превышать 15-й.
115115

116-
##### Списки
116+
##### <a name="Lists"></a> Списки
117117
Markdown поддерживает упорядоченные (нумерованные) и неупорядоченные (ненумерованные) списки.
118118
Для формирования неупорядоченный списков используются такие маркеры, как звездочки, плюсы и дефисы. Все перечисленные маркеры могут использоваться взаимозаменяемо.
119119
Для формирования упорядоченных списков в качестве маркеров используются числа с точкой. Важной особенностью в данном случае является то, что сами номера, с помощью которых формируется список, не важны, так как они не оказывают влияния на выходной HTML код. Как бы ни нумеровал пользователь список, на выходе он в любом случае будет иметь упорядоченный список, начинающийся с единицы (1, 2, 3…). Эту особенность стоит учитывать в том случае, когда необходимо использовать порядковые номера элементов в списке, чтобы они соответствовали номерам, получающимся в HTML.
@@ -181,7 +181,7 @@ Markdown поддерживает упорядоченные (нумерован
181181

182182
<исходный код >
183183

184-
##### Блоки кода
184+
##### <a name="CodeBlocks"></a> Блоки кода
185185
Отформатированные блоки кода используются в случае необходимости процитировать исходный код программ или разметки.
186186
Для создания блока кода в языке Markdown необходимо каждую строку параграфа начинать с отступа, состоящего из четырех пробелов или одного символа табуляции. Блок кода продолжается до тех пор, пока не встретится строка без отступа (или конец текста). Внутри блока кода амперсанды («&») и угловые скобки («<» и «>») автоматически преобразуются в элементы HTML разметки. Кроме того, следует отметить, что внутри блоков кода обычный синтаксис Markdown не обрабатывается.
187187
Блок кода в Markdown выглядит следующим образом:
@@ -190,7 +190,7 @@ Markdown поддерживает упорядоченные (нумерован
190190

191191
Это блок кода
192192

193-
##### Горизонтальные линии (разделители)
193+
##### <a name="Lines"> </a> Горизонтальные линии (разделители)
194194

195195
Для того чтобы создать горизонтальную линию с использованием синтаксиса языка Markdown, необходимо поместить три (или более)дефиса или звездочки на отдельной строке текста. Между ними возможно располагать пробелы.
196196
Горизонтальные линии в Markdown выглядят следующим образом:
@@ -217,7 +217,7 @@ Markdown поддерживает упорядоченные (нумерован
217217
Строчные элементы
218218
-------------------
219219

220-
##### Ссылки
220+
##### <a name="Links"></a> Ссылки
221221
Markdown поддерживает два стиля оформления ссылок:
222222

223223
- Гиперссылка, с немедленным указанием адреса (внутритекстовая);
@@ -268,7 +268,7 @@ Markdown позволяет также использовать неявно в
268268
[Example][]
269269
[Example]: http://example.com/
270270

271-
##### Выделение текста
271+
##### <a name="Emphasis"></a> Выделение текста
272272
Markdown воспринимает звёздочки «*» и символы подчёркивания «_» как признаки смыслового выделения текста:
273273

274274
- Текст, окружённый одиночными «*» или «_», будет заключен в HTML-тэг `<em>`.
@@ -301,14 +301,14 @@ Markdown воспринимает звёздочки «*» и символы п
301301

302302
___Пример___
303303

304-
##### Кодовые фрагменты строк
304+
##### <a name="Code"></a> Кодовые фрагменты строк
305305
Чтобы отметить фрагмент строки, содержащий код, необходимо окружить его обратными апострофами «`». При использовании кодовых фрагментов строк текст будет отображаться в виде моноширинного шрифта.
306306
В отличие от блоков кода, кодовый фрагмент позволяет поместить код внутрь обычного абзаца текста.
307307
Кодовый фрагмент строки в языке Markdown выглядит следующим образом:
308308

309309
Используйте оператор `if`
310310

311-
##### Изображения
311+
##### <a name="Images"></a> Изображения
312312
В Markdown существует 2 способа вставки изображений в документ:
313313

314314
a. С помощью непосредственного указания URL-адреса изображения. Синтаксис данной команды выглядит следующим образом:
@@ -334,7 +334,7 @@ b. С помощью метки-идентификатора. Синтакси
334334
Дополнительные элементы
335335
-------------------------
336336

337-
##### Обратный слеш
337+
##### <a name="Backslash Escapes"></a> Обратный слеш
338338
Может употребляться в Markdown перед специальными символами для того, чтобы они воспринимались в их буквальном (а не служебном) значении. Полный список данных символов приводится ниже:
339339

340340
«\» - слеш;
@@ -361,7 +361,7 @@ b. С помощью метки-идентификатора. Синтакси
361361

362362
«!» - восклицательный знак.
363363

364-
##### Автоматические ссылки
364+
##### <a name="Automatic Links"></a> Автоматические ссылки
365365
Markdown поддерживает упрощённый порядок автоматического создания ссылок для URL-адресов и адресов электронной почты. Для этого достаточно поместить URL-адрес или почтовый адрес в угловые скобки, и Markdown сделает его гиперссылкой. В отличие от вышеописанных стилей, в данном случае сам же URL-адрес или почтовый адрес становится и текстом гиперссылки. Автоматические ссылки на адреса электронной почты работают аналогично.
366366
Автоматические ссылки в языке Markdown выглядят следующим образом
367367

@@ -375,7 +375,7 @@ Markdown поддерживает упрощённый порядок автом
375375
В результате на экран выводится следующее:
376376
377377

378-
##### Специальные символы HTML
378+
##### <a name="SpecialSymbol"></a> Специальные символы HTML
379379
В языке HTML существует два символа, требующих специального рассмотрения: это символы («&lt;») и («&amp;»). Левая угловая скобка используется как начало тэга; амперсанды применяются для обозначения специального символа HTML.
380380
Для того чтобы использовать эти символы в их буквальном смысле, необходимо заменить их элементами HTML, а именно `&lt;` и `&amp;` соответственно.
381381
При использовании Markdown подобных действий совершать не нужно. Он позволяет использовать эти символы в исходном виде. В случае если амперсанд используется как часть спецсимвола HTML, он останется неизменным. В противном случае Markdown преобразует его в `&amp;`.

0 commit comments

Comments
 (0)