Символы

Кодировка

Для разметки текста в исключительном порядке применяют символы следующих кодировок: UTF-8, ASCII, ISO-8859-1. Это означает, что и основное содержание текста необходимо писать в одной из вышеназванных кодировок. Следовательно, русскоязычные тексты необходимо записывать в кодировке UTF-8, т.к. в кодировках ASCII и ISO-8859-1 нет кириллицы.

Публикуемый текст выводится в той же кодировке, что и исходный текст с разметкой. Т.е. если исходный текст в кодировке UTF-8, то и публикуемый текст будет в кодировке UTF-8.

Структурные элементы

Пробел и табуляция служат основными структурообразующими символами.

При разметке следует учитывать, что табуляция представляет собой четыре пробела. Это крайне важно при разметке списков, кода.

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

Экранирование

Экранирование символов разметки

Экранирование — это отдельный синтаксис для символов, применяемых Markdown для разметки текста.

Экранирование необходимо для следующих специальных символов:

\ (backslash) обратная косая черта;

` (backtick) обратная кавычка;

* (asterisk) звёздочка;

_ (underscore) подчёркивание;

{ } (curly braces) фигурные скобки;

[ ] (square brackets) квадратные скобки;

( ) (parentheses) круглые скобки;

# (hash) решётка;

+ (plus) плюс;

- (minus) дефис;

. (dot) точка;

~ (tilde) тильда;

! (exclamation) восклицательный знак.

Для экранирования следует перед символом поместить обратную косую черту (\).

Пример экранирования символов разметки:

* Пункт списка со звёздочкой \*.

* \[Текст в квадратных скобках\].

Результирующий код HTML:

<ul>

<li>Пункт списка со звёздочкой *.</li>

<li>[Текст в квадратных скобках].</li>

</ul>

Экранирование символов HTML

Некоторые символы имеют структурообразующее значение в синтаксисе языка публикаций HTML. Без обработки в исходном тексте разметки Markdown они могут вызвать синтаксические ошибки веб-страницы.

В случае, если размеченный текст предстоит публиковать в виде веб-страницы (в HTML), следует избегать символов:

меньше (<), который используется в HTML как левая угловая скобка;
больше (>), который используется в HTML как правая угловая скобка;
амперсанда (&), который используется для обозначения HTML объектов;
двойная кавычка ("), используемая для задания значений.

Для экранирования в HTML:

левой угловой скобки вместо меньше (<) следует использовать последовательность &LT;
правой угловой скобки вместо больше (>) следует использовать последовательность &GT;
двойной кавычки (") следует использовать последовательность &QUOT.

⚠️ Внимание! Избегайте амперсанда (&) в URL адресах! Это приводит к ошибкам в ссылках. Заменяйте амперсанд (&) на последовательность &AMP;

Примеры экранирования символов HTML:

Тег перевода строки: &LT;br /&GT;

[Ссылка](http://wiki.org&AMP;action=edit)

Результирующий код HTML:

<p>Тег перевода строки: &LT;br /&GT;</p>

<p><a href="http://wiki.org&AMP;action=edit">Ссылка</a></p>

В HTML предопределено большое количество спецсимволов. Чтобы вставить спецсимвол в разметку, нужно вставить соответствующую этому символу мнемонику. Полный список символов мнемоники HTML5 описан рекомендациями W3C.

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

Управляющие символы C0

&Tab; табуляция HT (ANSI), ГТ (ГОСТ)

" " двойная кавычка

&num; # номер, «решётка»

&percnt; % процент

&AMP; & амперсанд

' ' одинарная кавычка (апостроф)

( ( левая круглая скобка

) ) правая круглая скобка

&ast; * звёздочка

&period; . точка

/ / косая черта (солидус)

< < знак меньше

> > знак больше

&commat; @ коммерческий «эт»

[ [ левая квадратная скобка

] ] правая квадратная скобка

\ \ обратная косая черта

&UnderBar; _ подчёркивание

&grave; ` обратный апостроф (грейв)

{ { левая фигурная скобка

} } правая фигурная скобка

| | вертикальная черта

~ ~ занимающая позицию тильда

Управляющие символы C1

&NonBreakingSpace; неразрывный пробел

¦ ¦ разорванная вертикальная черта

§ § знак параграфа

&COPY; © знак охраны авторского права

« « левая двойная угловая кавычка

» » правая двойная угловая кавычка

° ° знак градуса

¶ ¶ знак абзаца

№ № знак номера

Расширение латиницы — B

&fnof; ƒ символ функции

Комбинируемые диакритические знаки

́ (аку́т) знак ударения ставится после буквы, над которой должен изображаться

Общая пунктуация

‑ неразрывный (неразделяемый) дефис

– – короткое тире

— — длинное тире

… … горизонтальное многоточие

Знаки валют

₽ ₽ рубль

¥ ¥ юань

€ € евро

Формы чисел

&half; ½ простая дробь «одна вторая»

&frac13; ⅓ простая дробь «одна треть»

¾ ¾ простая дробь «три четверти»

&frasl; ⁄ комбинируемый символ «дробь-черта» (1&frasl;2 → ½, 3&frasl;4 → ¾, 12&frasl;23 → 12⁄23)

Стрелки

← ← влево

↑ ↑ вверх

→ → вправо

↓ ↓ вниз

↔ ↔ влево-вправо

⇐ ⇐ двойная стрелка влево

&uArr; ⇑ двойная вверх

⇒ ⇒ двойная вправо

&dArr; ⇓ двойная вниз

⇔ ⇔ двойная влево-вправо

Геометрические фигуры

&loz; ◊ ромб