# Formatting comments

> Every Markdown syntax the LevelFour comment box understands, plus mentions, attachments, and the GitHub syntax it does not support.

Source: https://docs.levelfour.ai/guides/formatting-comments


Comments on a savings recommendation take Markdown. Every syntax below works in the comment box, and the last section names the GitHub syntax that does not.

> **Note**
>
> Comments are visible to everyone in your organization who can open the recommendation. Reactions and the Seen by row are visible too.

The composer has two tabs. **Write** is the plain-text editor, **Preview** renders the result.

> **Success**
>
> Anything shown in Preview is what other people will see once you post.

## Text styling

| You type                       | You get                      |
| ------------------------------ | ---------------------------- |
| `**bold**`                     | **bold**                     |
| `_italic_`                     | *italic*                     |
| `~~struck through~~`           | ~~struck through~~           |
| `` `inline code` ``            | `inline code`                |
| `**bold and _nested italic_**` | **bold and *nested italic*** |

## Headings

Start a line with one to six `#` characters, followed by a space.

```markdown
# Largest heading
## Second level
### Third level
```

The toolbar's **H** button inserts a `#` at the start of the current line.

## Line breaks and paragraphs

A single newline breaks the line. A blank line starts a new paragraph.

```markdown
First line.
Second line, directly below the first.

A new paragraph.
```

## Lists

```markdown
- Unordered item
- Another item
  - Indent two spaces to nest

1. Ordered item
2. Second item
```

Task lists render as checkboxes:

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

Checkboxes in a posted comment are read-only. Edit the comment to tick one.

## Links

Write a link as `[label](url)`. A bare URL becomes a link on its own, so `https://levelfour.ai` needs no markup.

Links open in a new tab.

## Quotes

Prefix a line with `>`:

```markdown
> Finance signed off on this in the Q3 review.
```

## Code

Multi-line code goes in a fenced block. Name the language after the opening fence:

````markdown
```bash
aws ec2 describe-volumes --filters Name=status,Values=available
```
````

Fenced blocks keep their whitespace and scroll sideways instead of wrapping, so command output and log excerpts stay readable.

## Tables

Separate cells with `|` and put a row of dashes under the header. A colon in the dash row sets the column alignment.

```markdown
| Account | Before/mo | Saved/mo |
|---|---:|---:|
| Production | $641.10 | $209.09 |
| Staging | $318.00 | $209.67 |
```

Leave a blank line before the table. A wide table scrolls sideways within the comment rather than stretching it.

## Horizontal rule

Three dashes on their own line draw a divider:

```markdown
---
```

## Mentioning a teammate

Type `@` followed by part of a name or email address. Pick someone from the list that appears and LevelFour inserts their name into your comment.

LevelFour notifies the person by email and in the app, with a link that opens the recommendation drawer at your comment. You can only mention members of your own organization.

> **Note**
>
> Editing a mention removes it. If you delete part of the name, the whole mention goes with it, so a comment never carries a half-broken reference.

## Attaching images and files

Ways to attach:

* **Paste.** Copy a screenshot and paste it into the comment box.
* **Drag and drop.** Drop the file onto the box.
* **Click.** Use the paperclip in the toolbar.

Images embed inline. Everything else becomes a download link.

> **Note**
>
> Attachments stay private to your organization. LevelFour stores them in its own bucket and serves them only to signed-in members of your workspace.

| Limit         | Value                |
| ------------- | -------------------- |
| Maximum size  | 10 MB per file       |
| Image formats | PNG, JPEG, GIF, WebP |
| Other formats | PDF                  |

Attaching a file inserts the Markdown for you. Move the cursor first if you want the attachment somewhere other than where you left off.

## Not supported

A few things GitHub does that LevelFour comments do not:

* **Raw HTML.** Tags show as text instead of rendering.
* **Emoji shortcodes.** `:tada:` stays literal. Paste the emoji character instead.
* **Issue and pull request autolinks.** `#123` is plain text. Use a full URL.
