Author
Patrick Bass Submitted
May 26, 2026 10:15pm Reviewed
May 26, 2026 10:15pm Summary
Initial version
+
# Markdown Guide
−
## Markdown Formatting Guide
+
All content on the platform — posts, replies, wiki pages, and direct messages — supports Markdown formatting. This guide covers every formatting option available.
−
This is the complete reference for formatting text in forums, wiki pages, messages, and other content areas across the platform. We use GitHub-flavored Markdown with some platform-specific extensions.
−
−
---
−
−
## Text Formatting
−
−
### Bold and Italic
−
−
```
−
**bold text**
−
*italic text*
−
***bold and italic***
−
~~strikethrough~~
−
```
−
−
**bold text**, *italic text*, ***bold and italic***, ~~strikethrough~~
−
−
### Superscript and Subscript
−
−
```
−
This is ^superscript^ text
−
This is ~subscript~ text
−
```
−
−
---
## Headings
+
Use `#` symbols to create headings. More `#` symbols mean smaller headings.
−
Use `#` symbols at the start of a line. The number of `#` determines the heading level.
```
+
# Heading 1
## Heading 2
### Heading 3
#### Heading 4
−
##### Heading 5
```
+
+
## Text Styling
+
| Syntax | Result |
+
|--------|--------|
+
| `**bold**` | **bold** |
+
| `*italic*` | *italic* |
+
| `~~strikethrough~~` | ~~strikethrough~~ |
+
| `` `inline code` `` | `inline code` |
−
Use Heading 2 (`##`) for main sections and Heading 3 (`###`) for subsections. Heading 1 is reserved for page titles.
+
Combine styles: `***bold and italic***` produces ***bold and italic***.
−
---
## Links
−
−
### Basic Links
```
[Link text](https://example.com)
+
[Link with title](https://example.com "Hover text")
−
[Link with title](https://example.com "Hover title")
```
+
URLs typed directly are auto-linked: `https://example.com` becomes a clickable link.
−
### Auto-linked URLs
−
−
Paste a full URL and it becomes a link automatically:
−
−
```
−
https://support.mobieus.io
−
```
−
−
### Internal Links
−
−
Link to other pages in the community:
−
−
```
−
[Visit the forums](/forums)
−
[See my profile](/profile/username)
−
[A wiki page](/know/getting-started)
−
```
−
−
---
## Images
−
−
### Inline Images
```
+
−
```
+
You can also drag and drop images into the editor — they are uploaded automatically and the markdown is inserted.
−
### Uploading Images
−
−
In the wiki editor and post composer, you can:
−
−
- Click the **Image** button in the toolbar
−
- **Drag and drop** an image onto the editor
−
- **Paste** a screenshot from your clipboard (Ctrl+V / Cmd+V)
−
−
The image uploads automatically and the markdown is inserted at your cursor.
−
−
### Image Sizing
−
−
Images display at their natural size up to the content width. There is no markdown syntax for resizing (use the upload at the desired resolution).
−
−
---
## Lists
+
### Unordered Lists
−
### Bullet Lists
```
+
- Item one
+
- Item two
−
- First item
−
- Second item
- Nested item
- Another nested item
+
- Item three
−
- Third item
```
+
### Ordered Lists
−
- First item
−
- Second item
−
- Nested item
−
- Another nested item
−
- Third item
−
−
### Numbered Lists
```
1. First item
2. Second item
3. Third item
```
−
−
1. First item
−
2. Second item
−
3. Third item
### Task Lists
```
- [x] Completed task
- [ ] Incomplete task
−
- [ ] Another task
```
−
−
- [x] Completed task
−
- [ ] Incomplete task
−
- [ ] Another task
−
−
---
## Blockquotes
```
> This is a blockquote.
> It can span multiple lines.
>
+
> > Nested blockquotes work too.
−
> And have multiple paragraphs.
```
+
## Code Blocks
−
> This is a blockquote. It can span multiple lines.
+
Wrap code in triple backticks. Specify a language for syntax highlighting:
−
### Nested Quotes
−
−
```
−
> First level
−
>> Second level
−
>>> Third level
−
```
−
−
---
−
−
## Code
−
−
### Inline Code
−
−
```
−
Use `backticks` for inline code like `variable` or `function()`.
−
```
−
−
Use `backticks` for inline code like `variable` or `function()`.
−
−
### Code Blocks
−
−
Use triple backticks for multi-line code. Add a language name after the opening backticks for syntax highlighting.
````
```javascript
function greet(name) {
return "Hello, " + name;
}
```
````
+
Supported languages include: javascript, python, php, css, html, sql, bash, json, and many more.
−
Supported languages include: javascript, python, php, html, css, sql, bash, json, xml, yaml, ruby, go, rust, java, c, cpp, csharp, typescript, markdown, and many more.
−
−
### Indented Code
−
−
Indent with 4 spaces for a code block (no syntax highlighting):
−
−
```
−
This is a code block
−
created with indentation
−
```
−
−
---
## Tables
```
+
| Column 1 | Column 2 | Column 3 |
−
| Header 1 | Header 2 | Header 3 |
|----------|----------|----------|
+
| Cell A | Cell B | Cell C |
+
| Cell D | Cell E | Cell F |
−
| Cell 1 | Cell 2 | Cell 3 |
−
| Cell 4 | Cell 5 | Cell 6 |
```
+
Align columns with colons:
−
| Header 1 | Header 2 | Header 3 |
−
|----------|----------|----------|
−
| Cell 1 | Cell 2 | Cell 3 |
−
| Cell 4 | Cell 5 | Cell 6 |
−
−
### Column Alignment
```
+
| Left | Center | Right |
+
|:-----|:------:|------:|
+
| A | B | C |
−
| Left | Center | Right |
−
|:---------|:--------:|---------:|
−
| Left | Center | Right |
```
−
−
Use `:` on the left for left-align, both sides for center, right side for right-align.
−
−
---
## Horizontal Rules
+
Three or more dashes, asterisks, or underscores on a line:
−
Three or more dashes, asterisks, or underscores on their own line:
```
---
−
***
−
___
```
−
−
---
## Mentions
+
Tag another member by typing `@username`. They receive a notification.
−
Tag another user with `@` followed by their username:
−
−
```
−
@username
−
```
−
−
The editor provides autocomplete suggestions as you type after `@`. The mentioned user receives a notification.
−
−
---
## Emoji
+
Type `:emoji_name:` to insert emoji. For example, `:thumbsup:` produces a thumbs-up emoji. The editor shows an autocomplete dropdown as you type.
−
You can use standard Unicode emoji by typing or pasting them directly. The emoji picker in the post composer provides a visual browser.
+
## Spoiler Tags
−
Common examples: :) :( :D <3
+
Hide content behind a spoiler toggle:
−
---
−
−
## HTML Support
−
−
A limited subset of HTML is allowed for advanced formatting:
−
−
**Allowed tags:** `<p>`, `<br>`, `<strong>`, `<b>`, `<em>`, `<i>`, `<u>`, `<a>`, `<ul>`, `<ol>`, `<li>`, `<code>`, `<pre>`, `<blockquote>`, `<h1>`-`<h6>`, `<img>`, `<hr>`, `<del>`, `<s>`, `<sup>`, `<sub>`, `<span>`, `<table>`, `<thead>`, `<tbody>`, `<tr>`, `<th>`, `<td>`, `<div>`
−
−
**Stripped on save:** `<script>`, `<iframe>` (except from approved embed hosts), event handlers (`onclick`, `onload`, etc.), inline JavaScript.
−
−
---
−
−
## Line Breaks
−
−
A single newline in markdown does not create a line break. To force a line break:
−
−
- Leave a blank line between paragraphs (creates a new `<p>`)
−
- End a line with two spaces followed by Enter (creates a `<br>`)
−
- Use `<br>` directly
```
+
||This text is hidden until clicked||
−
Line one (two trailing spaces)
−
Line two
−
−
Or a blank line for a new paragraph.
```
+
## Embedded Media
−
---
+
Paste a URL from supported providers (YouTube, Vimeo, Twitter, etc.) on its own line and it is automatically embedded as a rich preview.
−
## Escaping Special Characters
+
## Escaping Markdown
−
Prefix any markdown character with a backslash to display it literally:
+
Prefix a markdown character with a backslash to display it literally:
−
```
−
\*not italic\*
−
\# not a heading
−
\[not a link\]
−
\`not code\`
−
```
−
−
Characters that can be escaped: `\` `` ` `` `*` `_` `{` `}` `[` `]` `(` `)` `#` `+` `-` `.` `!` `|`
−
−
---
−
−
## Platform-Specific Features
−
−
### Post Mentions
```
+
\*This is not italic\*
+
\# This is not a heading
−
@username — mentions a user (sends notification)
−
```
−
−
### Gallery Embeds
−
−
In forum posts, you can embed a photo gallery inline:
−
−
```
−
[gallery=123]
```
−
−
Where `123` is the album ID.
−
−
### Video Embeds
−
−
Paste a YouTube, Vimeo, or other supported video URL on its own line and it auto-embeds as a player.
−
−
---
−
−
## Tips for Good Formatting
−
−
1. **Use headings** to organize long content. Start with `##` for sections.
−
2. **Keep paragraphs short.** One idea per paragraph. Blank lines between paragraphs.
−
3. **Use lists** for steps, features, or items. Easier to scan than paragraphs.
−
4. **Add code blocks** when sharing commands, configuration, or code. Always specify the language.
−
5. **Use tables** for structured comparisons. Keep columns concise.
−
6. **Include images** to illustrate complex topics. Add descriptive alt text.
−
7. **Link to other pages** within the community using relative URLs like `/know/page-slug`.
Markdown Guide
All content on the platform — posts, replies, wiki pages, and direct messages — supports Markdown formatting. This guide covers every formatting option available.
Headings
Use # symbols to create headings. More # symbols mean smaller headings.
# Heading 1
## Heading 2
### Heading 3
#### Heading 4
Text Styling
| Syntax | Result |
|---|---|
**bold** |
bold |
*italic* |
italic |
~~strikethrough~~ |
~~strikethrough~~ |
`inline code` |
inline code |
Combine styles: ***bold and italic*** produces bold and italic.
Links
[Link text](https://example.com)
[Link with title](https://example.com "Hover text")
URLs typed directly are auto-linked: https://example.com becomes a clickable link.
Images
You can also drag and drop images into the editor — they are uploaded automatically and the markdown is inserted.
Lists
Unordered Lists
- Item one
- Item two
- Nested item
- Another nested item
- Item three
Ordered Lists
1. First item
2. Second item
3. Third item
Task Lists
- [x] Completed task
- [ ] Incomplete task
Blockquotes
> This is a blockquote.
> It can span multiple lines.
>
> > Nested blockquotes work too.
Code Blocks
Wrap code in triple backticks. Specify a language for syntax highlighting:
```javascript
function greet(name) {
return "Hello, " + name;
}
```
Supported languages include: javascript, python, php, css, html, sql, bash, json, and many more.
Tables
| Column 1 | Column 2 | Column 3 |
|----------|----------|----------|
| Cell A | Cell B | Cell C |
| Cell D | Cell E | Cell F |
Align columns with colons:
| Left | Center | Right |
|:-----|:------:|------:|
| A | B | C |
Horizontal Rules
Three or more dashes, asterisks, or underscores on a line:
---
Mentions
Tag another member by typing @username. They receive a notification.
Emoji
Type :emoji_name: to insert emoji. For example, :thumbsup: produces a thumbs-up emoji. The editor shows an autocomplete dropdown as you type.
Spoiler Tags
Hide content behind a spoiler toggle:
||This text is hidden until clicked||
Embedded Media
Paste a URL from supported providers (YouTube, Vimeo, Twitter, etc.) on its own line and it is automatically embedded as a rich preview.
Escaping Markdown
Prefix a markdown character with a backslash to display it literally:
\*This is not italic\*
\# This is not a heading
# Markdown Guide
All content on the platform — posts, replies, wiki pages, and direct messages — supports Markdown formatting. This guide covers every formatting option available.
## Headings
Use `#` symbols to create headings. More `#` symbols mean smaller headings.
```
# Heading 1
## Heading 2
### Heading 3
#### Heading 4
```
## Text Styling
| Syntax | Result |
|--------|--------|
| `**bold**` | **bold** |
| `*italic*` | *italic* |
| `~~strikethrough~~` | ~~strikethrough~~ |
| `` `inline code` `` | `inline code` |
Combine styles: `***bold and italic***` produces ***bold and italic***.
## Links
```
[Link text](https://example.com)
[Link with title](https://example.com "Hover text")
```
URLs typed directly are auto-linked: `https://example.com` becomes a clickable link.
## Images
```
```
You can also drag and drop images into the editor — they are uploaded automatically and the markdown is inserted.
## Lists
### Unordered Lists
```
- Item one
- Item two
- Nested item
- Another nested item
- Item three
```
### Ordered Lists
```
1. First item
2. Second item
3. Third item
```
### Task Lists
```
- [x] Completed task
- [ ] Incomplete task
```
## Blockquotes
```
> This is a blockquote.
> It can span multiple lines.
>
> > Nested blockquotes work too.
```
## Code Blocks
Wrap code in triple backticks. Specify a language for syntax highlighting:
````
```javascript
function greet(name) {
return "Hello, " + name;
}
```
````
Supported languages include: javascript, python, php, css, html, sql, bash, json, and many more.
## Tables
```
| Column 1 | Column 2 | Column 3 |
|----------|----------|----------|
| Cell A | Cell B | Cell C |
| Cell D | Cell E | Cell F |
```
Align columns with colons:
```
| Left | Center | Right |
|:-----|:------:|------:|
| A | B | C |
```
## Horizontal Rules
Three or more dashes, asterisks, or underscores on a line:
```
---
```
## Mentions
Tag another member by typing `@username`. They receive a notification.
## Emoji
Type `:emoji_name:` to insert emoji. For example, `:thumbsup:` produces a thumbs-up emoji. The editor shows an autocomplete dropdown as you type.
## Spoiler Tags
Hide content behind a spoiler toggle:
```
||This text is hidden until clicked||
```
## Embedded Media
Paste a URL from supported providers (YouTube, Vimeo, Twitter, etc.) on its own line and it is automatically embedded as a rich preview.
## Escaping Markdown
Prefix a markdown character with a backslash to display it literally:
```
\*This is not italic\*
\# This is not a heading
```
