# Admonitions

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/help/writerside/llms.txt).

Tips, notes, and warnings are formatted text blocks for providing useful hints, highlighting potential problems, and informing readers about critical consequences. They are colored and have an icon to the left according to the admonition type.

Use the  [<tip>](semantic-markup-reference.html#tip) ,  [<note>](semantic-markup-reference.html#note) , and  [<warning>](semantic-markup-reference.html#warning)  elements to insert corresponding admonition blocks.

In Markdown topics, a blockquote is rendered as a tip by default. But you can change it using the `style` attribute in curly brackets after the blockquote.

## Tip

> **Tip:**
> Use a tip to provide optional information or helpful advice, like an alternative way of doing something.

Semantic markup:

```XML
<tip>
    Use a tip to provide optional information or helpful advice,
    like an alternative way of doing something.
</tip>
```

Markdown:

```
> Use a tip to provide optional information or helpful advice,
> like an alternative way of doing something.
```

## Note

> **Note:**
> Use a note for important information that the reader should be aware of, like known issues or limitations.

Semantic markup:

```XML
<note>
    Use a note for important information that the reader should be aware of,
    like known issues or limitations.
</note>
```

Markdown:

```
> Use a note for important information that the reader should be aware of,
> like known issues or limitations.
{style="note"}
```

## Warning

> **Warning:**
> Use a warning for critical information about potentially harmful consequences, such as damage or data loss.

Semantic markup:

```XML
<warning>
    Use a warning for critical information about potentially harmful consequences,
    such as damage or data loss.
</warning>
```

Markdown:

```
> Use a warning for critical information about potentially harmful consequences,
> such as damage or data loss.
{style="warning"}
```

## Quote

> Use a quote to insert a quotation or citation block from an external source. Unlike tips, notes, and warnings, quotes are neutral informational blocks without special styling or icons.

Semantic markup:

```XML
<quote>
    Use a quote to insert a quotation or citation block.
    Unlike tips, notes, and warnings, quotes are neutral informational blocks
    without special styling or icons.
</quote>
```

Markdown:

```
> Use a quote to insert a quotation or citation block from an external source.
> Unlike tips, notes, and warnings, quotes are neutral informational blocks
> without special styling or icons.
{style="quote"}
```