---
title: Contributor Guide & Formatting Reference
category: FAQ
---

# Contributor Guide & Formatting Reference

This page shows exactly what to type in `.md` files and how it will look on the website.

## Quick Start

Download starter file:

- [TSX Guide Starter Template](/downloads/TSX_Guide_Starter_Template.md)

## 1) Categories You Can Use

Use one of these in frontmatter:

- `FAQ`
- `New player`
- `Systems`
- `Events`

Type this:

```yaml
---
title: Your Guide Title
category: New player
---
```

Website output:

This sets the guide title in the list and places it in the selected category filter.

## 2) File Name (For Contributors)

Use any clear file name when you submit your guide.
The wiki team will handle the final published slug/file naming.

## 3) Full Minimal Guide Example

Type this:

```md
---
title: Example Event Guide
category: Events
---

# Example Event Guide

Short intro explaining what this event is.

## Schedule
- Monday: 19:00 Server Time
- Wednesday: 05:00 Server Time

## Rewards
- Win: 1,500,000 Silver, 10 CP, 3% EXP
- Lose: 750,000 Silver, 5 CP, 1.5% EXP

## Notes
> Rewards may change after balance updates.
```

Website output:

# Example Event Guide

Short intro explaining what this event is.

## Schedule
- Monday: 19:00 Server Time
- Wednesday: 05:00 Server Time

## Rewards
- Win: 1,500,000 Silver, 10 CP, 3% EXP
- Lose: 750,000 Silver, 5 CP, 1.5% EXP

## Notes
> Rewards may change after balance updates.

## 4) Common Blocks You Will Use

### Headings + Paragraphs

Type this:

```md
## How It Works
Enter during the 3-minute window and complete objectives before timer ends.
```

Website output:

## How It Works
Enter during the 3-minute window and complete objectives before timer ends.

### Bullets + Numbered Steps

Type this:

```md
### Requirements
- Level 90+
- 3,000,000 Silver

### Steps
1. Talk to Guard Captain.
2. Choose event.
3. Enter before gate closes.
```

Website output:

### Requirements
- Level 90+
- 3,000,000 Silver

### Steps
1. Talk to Guard Captain.
2. Choose event.
3. Enter before gate closes.

### Emphasis and Keys

Type this:

```md
Press `N` to open ranking.
Use **bold** for important values.
Use *italic* for optional emphasis.
```

Website output:

Press `N` to open ranking.
Use **bold** for important values.
Use *italic* for optional emphasis.

### Notes and Warnings

Type this:

```md
> Note: Times are Server Time.
> Warning: Unclaimed rewards are lost at next tier.
```

Website output:

> Note: Times are Server Time.
> Warning: Unclaimed rewards are lost at next tier.

## 5) Images (Best Practice)

Use image links that are publicly accessible (direct `https://...` URLs).
Do not use local computer paths.

Type this:

```md
![Image Alt Text](https://example.com/your-image.jpg)
```

Clickable image example:

```md
[![Image Alt Text](https://example.com/your-image.jpg)](https://example.com/your-image.jpg)
```

Website output:

![Image Alt Text](https://example.com/your-image.jpg)

## 6) Tables (Use HTML for Reliable Rendering)

Do not use pipe-style markdown tables.

Type this:

```html
<table class="wk-fac-mini-table">
  <thead>
    <tr>
      <th>Rank</th>
      <th>Reward (CP)</th>
    </tr>
  </thead>
  <tbody>
    <tr><td>Top 1</td><td>250</td></tr>
    <tr><td>Top 2</td><td>230</td></tr>
    <tr><td>Top 3</td><td>210</td></tr>
  </tbody>
</table>
```

Website output:

<table class="wk-fac-mini-table">
  <thead>
    <tr>
      <th>Rank</th>
      <th>Reward (CP)</th>
    </tr>
  </thead>
  <tbody>
    <tr><td>Top 1</td><td>250</td></tr>
    <tr><td>Top 2</td><td>230</td></tr>
    <tr><td>Top 3</td><td>210</td></tr>
  </tbody>
</table>

## 7) Contributor Checklist

Before submitting a guide, confirm:

- Title is clear and specific
- Category is correct
- Sections are short and readable
- Values are formatted consistently (`Silver`, `CP`, `%`)
- Image links are public and visible without login
- Table uses HTML format
- Notes include any “subject to change” warning