Text Formatting Guide

This guide explains the formatting available in card text fields, including markdown, alignment, leader lines, and inline dice.

1) Markdown Formatting

Bold

Wrap text in double asterisks:

**bold text**

Italic

Wrap text in single asterisks:

*italic text*

Bold + Italic

Wrap text in triple asterisks:

***bold italic text***

Notes:

Formatting applies inline only.
Unmatched asterisks are treated as literal text.

2) Text Alignment

Alignment can be changed using directives:

Align a whole line (alignment is per line)

Each directive affects the next line you write.

:::al This line is left aligned.:::
 :::ac This line is centered.:::
 :::ar This line is right aligned.:::

3) Leader Lines

Leader lines are written as:

[Label[.]Value]

Example:

[Cost[.] 50 gold]

How it looks:

Cost............................................................50 gold

The `.` inside `[.]` defines the leader character.

What it does:

A leader line is a single line split into a **left label** and a **right value**.
The separator (default `.`) fills the space between them (like dotted lines in a menu).
Use it for “Label … Value” layouts (e.g., Cost, Range, Duration, etc.).

More examples:

[Range[.] 3 squares][Weight[-] Light][Difficulty[ ] Hard]

Advanced Grouping (0.5.3+ only)

Advanced grouping lets you control how leader lines align across a set of entries. Use it when you want consistent alignment across multiple rows, or when you need precise control over where values begin.

Why group? It lets you align all values to the same column, which makes lists easier to scan.
Why pivot? It sets the exact column where values start, so you can align values by eye or to a design grid.
Why wrap? It controls whether long values can wrap inside the value column or stay on one line.

Group start/end:

[[
...
]]

Single entry group (same behavior as ungrouped):

[[
[hello[.]World]
]]

Multiple entries (multi-line). Values align to the same column:

[[
[hello[.]World]
[hello[.]Universe]
]]

Fixed pivot (50%). Values start at the midpoint of the text bounds:

[[
[{pivot:50%, wrap:value}]
[Cost[.] 50 gold]
[Range[.] 3 squares]
]]

Wrap enabled (values wrap within the value column). Useful for long descriptions:

[[
[{pivot:60%, wrap:value}]
[Effect[.] This effect lasts until the end of the round]
[Note[.] Only applies to heroes]
]]

No wrap (values stay on a single line). Useful when you want a clean right edge:

[[
[{wrap:none}]
[hello[.]World]
[hello[.]Universe]
]]

Single-line, comma-separated group (compact input):

[[[{wrap:none}],
[hello[.]World],
[hello[.]Universe]]]

4) Inline Dice (0.5.3+ only)

Combat dice (skull/hero/monster)

&cd-w-s; (white skull)

&cd-r-h; (red hero shield)

&cd-bk-m; (black monster shield)

&cd-g-s; (green skull)

&cd-bl-h; (blue hero shield)

&cd-y-m; (yellow monster shield)

&cd-o-s; (orange skull)

&cd-p-h; (purple hero shield)

&cd-gy-m; (grey monster shield)

D6 (movement dice)

&d6-1-w; (white die with 1 pip)

&d6-2-r; (red die with 2 pips)

&d6-3-bl; (blue die with 3 pips)

&d6-4-g; (green die with 4 pips)

&d6-5-y; (yellow die with 5 pips)

&d6-6-bk; (black die with 6 pips)

Generic dice faces

&cd-cd-w; (Combat Die)

&cd-ad-r; (Attack Die)

&cd-dd-bk; (Defense Die)

&cd-md-g; (Movement Die)

5) Inline Dice (Advanced Usage)

Order flexibility

&cd-w-s; (color then face)

&cd-s-w; (face then color)

Face/Pip color override

&cd-y-s-bk; (yellow die, black skull)

&cd-bk-h-y; (black die, yellow hero)

&cd-w-m-r; (white die, red monster)

&cd-r-s-w; (red die, white skull)

&cd-g-h-bk; (green die, black hero)

&cd-p-m-y; (purple die, yellow monster)

&d6-2-y-bk; (yellow die, black pips)

&d6-4-bk-w; (black die, white pips)

&d6-6-r-gy; (red die, grey pips)

Hex colors (including alpha)

&cd-s-#ff0; (yellow die)

&cd-s-#ff08; (yellow die @ ~53% alpha)

&cd-s-#ff000080; (red die @ 50% alpha)

&cd-s-#fff-#000; (white die, black skull)

6) How Dice Tokens Are Structured

Combat dice token

&cd-<face>-<color>-<faceColor?>;

Faces:

`s` = skull
`h` = hero shield
`m` = monster shield
`cd` = Combat Die
`ad` = Attack Die
`dd` = Defense Die
`md` = Movement Die

D6 token

&d6-<number>-<color>-<faceColor?>;

Numbers:

`1` to `6`

Colors

Short codes (name + example):

`w` = white → `&cd-w-s;`
`bk` = black → `&cd-bk-s;`
`r` = red → `&cd-r-s;`
`bl` = blue → `&cd-bl-s;`
`g` = green → `&cd-g-s;`
`y` = yellow → `&cd-y-s;`
`o` = orange → `&cd-o-s;`
`p` = purple → `&cd-p-s;`
`gy` = grey → `&cd-gy-s;`

Hex colors (format + example):

`#RGB` → `&cd-s-#ff0;`
`#RGBA` → `&cd-s-#ff08;`
`#RRGGBB` → `&cd-s-#ffcc00;`
`#RRGGBBAA` → `&cd-s-#ffcc0080;`

Defaults:

If face/pip color is not provided, it auto-contrasts

(white on colored dice, black on white dice).

Quick Examples

&cd-w-s;

&cd-r-h;

&cd-bk-m;

&d6-1-w;

&d6-3-g;

&d6-6-bk;

&cd-ad-r;

&cd-dd-bk-w;

&cd-md-g;

&d6-2-y-bk;

&cd-s-#fff-#000;