# Wiki Markdown Features

The wiki uses standard Markdown (GitHub Flavored) plus several custom extensions.

## Standard Markdown

All standard GFM features work:
- **Bold**, *italic*, ~~strikethrough~~
- Links, images, code blocks
- Tables, task lists (`- [ ]` and `- [x]`)
- Headings automatically get anchor IDs for linking

## Color Tags

Add color to any text using `{color}text{/color}` syntax.

**Available colors (16):**

{red}red{/red} · {green}green{/green} · {blue}blue{/blue} · {yellow}yellow{/yellow} · {orange}orange{/orange} · {purple}purple{/purple} · {cyan}cyan{/cyan} · {magenta}magenta{/magenta} · {pink}pink{/pink} · {brown}brown{/brown} · {gold}gold{/gold} · {silver}silver{/silver} · {teal}teal{/teal} · {lime}lime{/lime} · {grey}grey{/grey} · {white}white{/white}

**Usage:**
```
{purple}ShatteredRose{/purple} enters the caern.
The {red}Wyrm{/red} taint is strong here.
```

## Image Sizing

Control image display size using the `|size` syntax in the alt text.

**Size presets:**

| Preset | Approximate Width |
|--------|-------------------|
| `thumb` | Small thumbnail |
| `small` | ~25% width |
| `medium` | ~50% width |
| `large` | ~75% width |
| `full` | 100% width |

**Custom pixel size:** Use a number (1-2000):

```
![Map|medium](/assets/map.jpg)
![Portrait|200](/assets/portrait.jpg)
![Banner|full](/assets/banner.jpg)
```

## Image Positioning

Add a position after the size to float images:

```
![Portrait|small|left](/assets/portrait.jpg)
![Map|medium|right](/assets/map.jpg)
![Banner|large|center](/assets/banner.jpg)
```

Positions: `left` (float left), `right` (float right), `center` (centered block).

## Card Layouts

Create a two-column layout with an image and text side by side:

```
![Character Name|card|left](/assets/character.jpg)
**Name:** Storm Runner
**Tribe:** Get of Fenris
**Auspice:** Ahroun

A veteran warrior who has seen too many battles...
---
```

The `---` at the end closes the card. The image appears on the specified side (left or right) with the text beside it.

## Access Control

Restrict a page to specific roles by adding a directive as the **first line**:

```
@@admin
# Secret ST Page

This page is only visible to users with the admin role.
```

Multiple roles can be specified:
```
@@admin,gm
```

Pages without a directive are visible to everyone.

## Navigation Editing

The navigation menu is a Markdown file at `_templates/navigation.md`. Structure:

```markdown
- [Home](/)
- [Overview](/overview)
- Section Name
  - [Page One](/page-one)
  - [Page Two](/page-two)
- @@admin Admin Section
  - @@admin [Secret Page](/secret)
  - @@admin [Another Secret](/another)
```

**Rules:**
- Top-level items are main nav links
- Indented items become dropdown menus under the parent
- `@@admin` before a link or section heading hides it from non-admin users
- Edit through the admin navigation editor on the wiki