Пример оформления

опциональное описание внешнего вида или комментарий

Описание действия. Если тут будет использоваться какая-то терминология, то по-хорошему, она будет оформлена ссылкой, например R1+0. В заголовке этого действия ссылки не работают, потому что вместо нормальных тегов там плейсхолдеры. Снизу всё должно работать.

Описание бонусного действия. Возможно, ссылка на диаграмму:

описание того, как противники видят эффекты, aka как судья им описывает происходящее

Для разметки страницы используется диалект markdown/html.

По умолчанию он просто заменяет ~abc{def} на <abc>def</abc>. Ниже пример кода на нём:

~h1{заголовок}
~p{ Параграф.
} ~~ ~} - отдельные символы тильды
и закрывающей фигурной скобки. ~x{комментарий} ~hr; ~x{тег без тела} ~x{а, ну
и да, внутри тега x пишутся комментарии, которые удаляются после конвертации
в html. если вам это кажется глупым - вспомните, как комментарии обозначаются
в html/md} ~{пустой тег пропускает текст как есть и используется для
экранирования текста внутри "макросов"}

для обратной совместимости с HTML атрибуты указываются так:
~img(src="abc.jpg");

В качестве входа у транслятора допустимы только печатные UTF-8 символы. CR игнорируется, TAB считается шириной в 4 пробела.

Если нужно экранировать большой кусок текста, можно это делать с помощью "here-string": ~tag:STOP_WORD{ dweden ;onfiwrf nlwei fwlie fSTOP_WORD}.

Перед конвертацией в html транслятор раскрывает специальные теги:
~md{} - вставка md-подобного кода
~ln{текст;ссылка} - альтернатива ~a(href="ссылка"){текст}

Специфичные для сайта:
~lbl{} и ~term{} - стилизация ссылок на терминологию. Если содержимое соответствует одной из регулярок, генерирует ссылку на нужную терминологию. ~lbl{} используется в качестве тега способности.
~board{} - вставка доски с подписью
~tbl{} - таблицы. мне не нравятся таблицы маркдауна, поэтому в планах заменить их на roff-подобные.

~md{} поддерживает MarkDown частично. зачёркнутый текст обозначается --так--, наклонный //так//, скрытый - не поддерживает. вложенные списки обозначаются дополнительным рядом звёздочек, а не отступом. упорядоченных списки обозначаются точками.
Вставок кода тоже нет, пока что обхожусь ~pre{~code{}}

Возможно, эта информация устарела (но вряд ли что-то станет хуже!)

~md{# Пример оформления
## Имя способности
~tbl{
владелец | запас | привязка |
имя игрока, впервые сыгравшего ею | максимальная хранимая энергия | фигура(ы), к которой способность ~ln{привязана;/chess/terms#фигура-владелец} |.
}
### Ссылки (обычно не требуются)

* [ссылка на используемую терминологию, если потребуется]()
* [другая ссылка]()

> опциональное описание внешнего вида или комментарий

### Название_действия цена_действия тег ~opt{бонусный тег}

Описание действия. Если тут будет использоваться какая-то терминология, то по-хорошему, она будет оформлена ссылкой, например ~term{R1+0}. В заголовке этого действия ссылки не работают, потому что вместо нормальных тегов там плейсхолдеры. Снизу всё должно работать.

### ~opt{Название бонусного действия} ~lbl{2} ~lbl{пасс} ~opt{~lbl{множ}}

Описание бонусного действия. Возможно, ссылка на диаграмму: ~board{small_board;}

## Внешний вид
описание того, как противники видят эффекты, aka как судья им описывает происходящее

## Примечания
* примечание 1
* примечание 2
}