Документация Размер: 10 857 байт (10.6 КБ). Символов: 6 377 (без шаблонов), 6 702 (с шаблонами). Изменена 23:59:00 31.12.9999. Меток нет.

Справка по разметке

Базовое форматирование текста

Жирный текст выделяется **двойными звёздочками** или __двойными знаками нижнемго подчёркивания__.
Курсивный текст выделяется *одинарными звёздочками* или __одинарными знаками нижнего подчёркивания__.
***Тройные звёздочки*** или ___тройные знаки нижнего подчёркивания___ становятся жирным курсивом.
Зачёркнутый текст выделяется ~~двойными тильдами~~.
Моноширинный текст (для кода) выделяется одной или двумя обратными кавычками для однострочников и тремя или более обратными кавычками для многострочников:

**Раз ромашка**
*Два ромашка*
___Три ромашка…___
~~А я четвёртую сорву!~~

Заголовки

Заголовки создаются с помощью символа # в начале строки. Количество символов # определяет уровень заголовка:

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

Горизонтальная линия

Горизонтальная линия создаётся с помощью трёх или более дефисов, звездочек или знаков подчёеркивания в начале строки:




---
****
______

Цитаты

Цитаты или стихотворения начинаются с символа > в начале строки:

Это цитата
Продолжение цитаты
Может быть, это стихотворение?
Уж очень длинное!

> Это цитата
> Продолжение цитаты
> Может быть, это стихотворение?
> Уж очень длинное!

Спойлеры

Спойлеры создаются с помощью тройных знаков процента:

Название спойлера
%%% Название спойлера
Содержимое спойлера
%%%

Ссылки

Ссылки создаются в формате [текст](ссылка на файл без .md). Поддерживаются якоря (#), в том числе и внутренние (для таких достаточно в ссылке указать только якорь).
Разумеется, в ссылках может быть разметка. Если текст ссылки и ее адрес совпадают, придется указывать и то, и то. Особенности Markdown.

https://google.com
Google
Документация
И это тоже документация
А это с якорем

[https://google.com](https://google.com)
[Google](https://google.com)
[Документация](Документация)
[И это **тоже** документация](Документация)
[А это с якорем](#Ссылки)

Изображения

Синтексис вставки медиафайлов подобен ссылкам, но с восклицательным знаком в начале:

![Подпись|Тип выравнивания|Размер в пикселях](Файл изображения)

Имя файла, подпись, выравнивание и размер

Ссылка на файл — единственный обязательный параметр. Подпись может быть пропущена без каких-либо последствий, но квадратные скобки придется поставить.
По умолчанию изображение выводится с шириной, указанной в настройках (параметр image_width). Если нужно вывести изображение в натуральную величину, следует указать размер 0. Так как порядок параметров определен жёстко, первые два параметра придется указать в любом случае.

Изображение в натуральную величинуИзображение в натуральную величину

![Изображение в натуральную величину||0](example.png)

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

  • align-center — выравнивание по центру без обтекания. Этот тип выставляется по умолчанию, если значение не указано явно.
  • align-left — выравнивание по левому краю без обтекания.
  • align-right — выравнивание по правому краю без обтекания.
  • float-left — выравнивание по левому краю с обтеканием.
  • float-right — выравнивание по правому краю с обтеканием. Это наиболее соответствует тому, как выглядят изображения в Википедии.

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

![float-left, 200 пикселей|float-left|200](example.png)
![float-right, 300 пикселей|float-right|300](example.png)

float-left, 200 пикселейfloat-left, 200 пикселей
float-right, 300 пикселейfloat-right, 300 пикселей

Аудиозаписи

Будет описано.

Списки

Многоуровневые списки создаются с помощью дефиса - с двухпробельными отступами. Можно делать как нумерованные, так и ненумерованные списки. В качестве маркеров ненумерованных списков выступают знаки плюча, дефисы или звездочки + * -, для нумерованных списков можно использовать числа (причём любые):

  • Элемент списка 1
    1. Вложенный элемент 1.1
    2. Вложенный элемент 1.3
    3. Вложенный элемент 1.9
  • Элемент списка 2
  • Элемент списка 3
- Элемент списка 1
  1. Вложенный элемент 1.1
  3. Вложенный элемент 1.3
  9. Вложенный элемент 1.9
- Элемент списка 2
- Элемент списка 3

Абзацы и переносы строк

Одиночный перенос строки преобразуется в тег <br>. Двойной или более перенос строки создаёт новый абзац, который оборачивается в тег <p>.

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

Шаблоны

Всё как в Википедии. Шаблоны являются обычными страницами без каких-то особых меток. Рекурсивные и вложенные шаблоны недопустимы. Синтаксис вызова шаблона:

{{Название шаблона
| Значение переменной 1
| Значение переменной 2
|| Можно пропускать переменные}}

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

{{Этот текст не будет отображён, если переменная не определена. @}}

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

Загрузка страницы

При загрузке страницы к ней частично применяется функция markdown(), однако поведение её отличается:

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

Вернуться