Для форматирования постов и комментариев в Point используется урезанный вариант Markdown — облегченного языка разметки.
Ниже приведены примеры использования Markdown, однако это далеко не полное руководство. Полное описание языка может быть найдено на официальном сайте.
Символы, которые обычно рассматриваются в Markdown как специальные, могут быть экранированы с помощью обратного слеша. Например, последовательность «\*» выведет символ «*», а не будет являться признаком начала выделенного текста.
Текст с выделением или логическим ударением
*выделение* (например, курсив)
**сильное выделение** (например, полужирное начертание)
~~перечёркнутый текст~~
Программный код
`какой_то_программный_код($аргумент)`
или
какой-то программный код
с отступом от начала строки
4 знака
или
```
какой_то_программный_код($аргумент)
```
Также поддерживается подсветка синтаксиса. Для включения подсветки необходимо указать язык:
```python
def foo():
return bar
```
Списки
Ненумерованные:
* элемент маркированного списка
- ещё один элемент ненумерованного списка
+ буллеты элементов могут быть разными
Нумерованные:
1. Элемент нумерованного списка
2. Элемент №2 того же списка
9. Элемент №3 списка — элементы нумеруются по порядку,
цифра в начале строки не имеет значения
Списки должны отделяться от текста пустой строкой.
Заголовки
Создание заголовков производится путём помещения знака решетки перед текстом заголовка. Количество знаков «#» соответствует уровню заголовка.
HTML предоставляет 6 уровней заголовков.
# Заголовок первого уровня
#### Заголовок четвёртого уровня
После знаков #
обязателен хотя бы один пробел.
Первые два уровня заголовка также имеют альтернативный синтаксис:
Заголовок первого уровня
========================
Заголовок второго уровня
------------------------
Цитаты
> Данный текст будет заключен в HTML-тег <blockquote>.
Ссылки
[Текст ссылки](адрес://ссылки.здесь "Заголовок ссылки")
или
[Текст ссылки][тег]
и где-нибудь в документе (например в самом низу)
[тег]: адрес://ссылки.здесь "Заголовок ссылки"
Сноски
Сноска состоит из метки и непосредственно текста сноски (содержимого).
Пример синтаксиса Markdown:
Сноски[^1] состоят из метки[^@#$%] и содержимого.
[^1]: Это содержимое.
[^@#$%]: Сноска по метке: "@#$%".
Метка определяется как любой текст, в том числе содержащий пробелы, который заключен в квадратные скобки []
и начинается с символа каретки (циркумфлекса) ^
. При этом специальное значение имеет только первая каретка.
Примеры меток:
[^Metka]
[^1]
- <code>[ˆ12]</code>
Содержимое сноски состоит из метки (она должна быть полностью идентична метке в теле текста, включая пробелы и регистр букв), за которой следует двоеточие и по меньшей мене один пробел.
[^Metka]: Текст сноски.
Непосредственно текст сноски может начинаться сразу за меткой, или же со следующей строки (это может быть удобным при использовании нескольких блоков текста, что с учётом использования отступов позволит избежать возможных ошибок). Текст сноски может содержать абзацы, блоки кода, цитаты, и почти любое форматирование Markdown1.
Следующие за первой строки должны предваряться отступом на один уровень (четыре пробела или один символ табуляции).
[^1]:
Первый абзац.
Второй абзац.
> Многострочная цитата
> из двух строк.
# some Pyhon code
print "Hello world!"
Последний абзац.
По умолчанию сноски располагаются в конце текста, но их можно разместить и в тексте. Для этого необходимо в месте, где вы хотите видеть сноски, добавить специальный маркер:
///Footnotes Go Here///
например:
Сноски[^1] состоят из метки[^@#$%] и содержимого.
///Footnotes Go Here/// ← сноски будут здесь.
Какой-то текст после сносок.
[^1]: Это содержимое.
[^@#$%]: Сноска по метке: "@#$%".
Изображения
![Alt-текст](URL изображения "Заголовок изображения")
Спойлеры
%%текст под спойлером%%
В web-интерфейсе элементы страницы, находящиеся внутри спойлера, будут отображаться только при наведении на них указателя мыши. В XHTML-IM содержимое отображается черным текстом на черном фоне, причем изображения заменяются на ссылки на них.
-
В оригинале документации:
The content may contain multiple lines, paragraphs, code blocks, blockquotes and most any other markdown syntax.