1. Рятуємо читача від «простирадла» тексту

В епоху швидкого контенту ніхто не подужає суцільну стіну літер на три екрани телефона. Око втомлюється, увага розсіюється, вкладка закривається. Тексту потрібне повітря. Для цього у вас є простий набір прийомів:

  • Короткі абзаци. Один абзац - одна закінчена думка (3–5 рядків максимум). Відокремлюйте їх порожнім рядком.
  • Заголовки ## та ###. Вони будують кістяк статті. Головний заголовок з однією решіткою ставити не потрібно: назва статті вже є головним заголовком сторінки.
  • Списки. Якщо перелічуєте переваги спорядження чи кроки прокачки - використовуйте дефіс або цифри, а не пишіть усе через кому.
  • Виноски (Callouts). Чудово підходять для ремарок майстра, нюансів правил або підсумків.

2. Інтерактив і магія бази знань Onyx

Головна перевага статей в Onyx - живий зв'язок із довідником. Вам не треба вручну розписувати дію закляття чи характеристики монстра.

  1. Посилання на записи: вказуйте англійську назву в фігурних дужках. Наприклад, тег закляття Fireball створить посилання: Fireball.
  2. Відмінювання та переклад: щоб слово органічно звучало в реченні, додайте після прямої риски текст, який побачить читач. Наприклад: лежачим або гоблінів.
  3. Клікабельні кубики та складності: можна додавати інтерактивні кидки: 2d6 + 3 для шкоди, 1d20 + 4 для перевірки, або позначку КС 15.
  4. Окремі картки: спеціальний рядок формату ::spell|Shield:: створює повноцінну інтерактивну картку запису на всю ширину.

3. Баланс тегів: менше шуму, більше сенсу

Посилання та теги чіпляють погляд. Але якщо переборщити, текст перетвориться на строкато розфарбовану новорічну ялинку, яку неможливо нормально прочитати.

❌ Невдалий приклад:

Візьміть Bard, виберіть Elf, кастіть Vicious Mockery на Goblin, доки він не отримає prone, а потім біжіть через Dash і кидайте 1d4 шкоди з 13.

Чому це погано: Суцільний візуальний шум. Теги на кожному кроці знецінюють самі себе, спотикають погляд і руйнують зв'язність мови.

✅ Вдалий приклад:

Для барда дистанція - питання життя. Якщо ворог підійшов занадто близько, збийте лідера з ніг у стан лежачого або дістаньте його злою насмішкою (13, 1d4 шкоди при успішному). Після цього лишається активувати дію «Ривок» і безпечно втекти й лишити своїх товаришів помирати.

Чому це працює: Звучить природно. Посилання підкреслюють тільки ключові механіки, які читачеві може знадобитися розгорнути або прокинути кубом.


4. Шпаргалка найчастіших тегів

Ось як записуються найпопулярніші теги (можна просто скопіювати звідси потрібний рядок і підставити свою назву):

{@spell Misty Step}               -> посилання на закляття
{@spell Fireball|вогняна куля}    -> закляття зі своєю назвою
{@item Moonblade}                 -> посилання на предмет
{@condition blinded|осліплений}   -> стан персонажа
{@creature Owlbear|сововедмедя}   -> істота з бестіарію
{@dice 1d20 + 4}                  -> кнопка кидка кубиків
{@damage 3d6}                     -> кнопка кидка шкоди
{@dc 14}                          -> плашка складності (КС 14)
::spell|Counterspell::            -> окрема картка закляття (з нового рядка)