> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.fluxerlist.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.fluxerlist.com/_mcp/server.

# Format your description

Markdown works in the **Long Description** field when you add or edit a server, bot, or theme. The short description is plain text only.

The editor has an **emoji picker** with search, categories, and skin tones. Pick an emoji and it drops in where your cursor is.

> **Tip**
>
> Use headings to break your description into sections, tables to document commands, and highlights sparingly for the one thing you want people to notice.

## Headings

Start from `#` or `##` for top-level sections and don't skip levels.

```markdown
# Heading 1
## Heading 2
### Heading 3
```

## Bold, italic, and strikethrough

```markdown
**bold text**
*italic text*
***bold and italic***
~~strikethrough~~
```

## Lists and task lists

```markdown
- First item
- Second item

1. First step
2. Second step

- [x] Done
- [ ] Not done yet
```

Task lists work well for showing bot features or setup steps as a checklist.

## Tables

The separator row is required, and column widths don't need to line up.

```markdown
| Command | Description        |
| ------- | ------------------ |
| !help   | Lists all commands |
| !play   | Plays a song       |
```

Control alignment with colons in the separator row.

```markdown
| Left | Center | Right |
| :--- | :----: | ----: |
| A    |   B    |     C |
```

## Blockquotes

Useful for notices, tips, or quoting your bot's replies.

```markdown
> This is a blockquote.
> It can span multiple lines.
```

## Code blocks

Wrap code in triple backticks.

````markdown
```
!help
!play <song>
!queue
```
````

> **Warning**
>
> Single backticks render as plain text on FluxerList. Only triple backticks create a styled code block.

## Links

```markdown
[Link text](https://example.com)
```

All links open in a new tab. Only include relevant links, because spam or unrelated links can get a listing rejected.

## Highlight

Wrap text in double equals signs. This is FluxerList's own extended syntax.

```markdown
Use ==highlight== to draw attention.
```

## Subscript and superscript

```markdown
H~2~O
E = mc^2^
```

Strikethrough uses double tildes. Single tildes are reserved for subscript.

## Emoji

Type a shortcode and it renders as the emoji.

```markdown
That is so funny! :joy:
```

| Shortcode    | Emoji | Shortcode   | Emoji | Shortcode  | Emoji |
| ------------ | ----- | ----------- | ----- | ---------- | ----- |
| `:joy:`      | 😂    | `:smile:`   | 😊    | `:heart:`  | ❤️    |
| `:fire:`     | 🔥    | `:rocket:`  | 🚀    | `:tada:`   | 🎉    |
| `:thumbsup:` | 👍    | `:star:`    | ⭐     | `:check:`  | ✅     |
| `:x:`        | ❌     | `:warning:` | ⚠️    | `:bulb:`   | 💡    |
| `:robot:`    | 🤖    | `:crown:`   | 👑    | `:trophy:` | 🏆    |
| `:sparkles:` | ✨     | `:clap:`    | 👏    | `:eyes:`   | 👀    |
| `:thinking:` | 🤔    | `:zap:`     | ⚡     | `:sob:`    | 😭    |
| `:wink:`     | 😉    | `:muscle:`  | 💪    | `:shield:` | 🛡️   |

## Footnotes

Footnotes render as superscript numbers with a reference section at the bottom.

```markdown
Here's a sentence with a footnote.[^1]

[^1]: This is the footnote text.
```

## Heading IDs

Add a custom ID to link straight to a section. The ID must be lowercase, with hyphens for spaces.

```markdown
## My Section {#my-section}
```

## Horizontal rules and paragraphs

```markdown
Text above

---

Text below
```

Leave a blank line between paragraphs. A single line break inside a paragraph is treated as a space.

## A complete example

```markdown
## What this bot does

A music bot for Fluxer communities. ==Free, no premium tier.== :tada:

### Commands

| Command | Description     |
| ------- | --------------- |
| !play   | Plays a song    |
| !queue  | Shows the queue |

### Setup

- [x] Invite the bot
- [ ] Give it a Music role
- [ ] Run !help in any channel

> Need help? Join our support server.
```