> ## Documentation Index
> Fetch the complete documentation index at: https://docs.piebald.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Chat rendering features

Piebald brings special features to the chat view—admonitions/callouts, automatic color swatches, clickable file references, and more.

## Clickable file references

<Badge color="green">Available in [Piebald Pro](https://piebald.ai/pricing)</Badge>

File or folder paths that the model references in its responses can be highlighted with a colored file-type-specific icon and made clickable.  Clicking on them will open the file or folder in the integrated code editor.

Hovering over a reference will load the file and show it with syntax highlighting, similar to file-\@mentions:

<img className="shadow-md rounded-xl" width="600" alt="Image" src="https://mintcdn.com/piebald/-AaSH-LxuVoxYcZl/imgs/clickable_hover_with_icons.png?fit=max&auto=format&n=-AaSH-LxuVoxYcZl&q=85&s=3edd8904944f65faa188b9820529908d" data-path="imgs/clickable_hover_with_icons.png" />

## Markdown admonitions

<Badge color="green">Available in [Piebald Pro](https://piebald.ai/pricing)</Badge>

It's common for markdown renderers to support what are known as **admonitions, callouts,** or **alerts.** They're useful for things like notices or warnings in documentation. The syntax is similar to the blockquote syntax (`>`) but with an additional marker:

```markdown theme={null}
> [!NOTE]
> This is a **note.**
```

On the [Pro](https://piebald.ai/pricing) plan, Piebald natively supports rendering admonitions using [GitHub-flavored syntax:](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#alerts)

<img className="shadow-md rounded-xl" width="800" alt="Screenshot of a sample of an AI response about JavaScript testing libraries, which includes a blue 'Note' callout block." src="https://mintcdn.com/piebald/J4noBc8CRvusXw9Z/imgs/v0-1-9/github_flavored_callout.png?fit=max&auto=format&n=J4noBc8CRvusXw9Z&q=85&s=3fb30f27ce8a51b3b41025e62f269c0e" data-path="imgs/v0-1-9/github_flavored_callout.png" />

### Getting the model to use admonitions

For now, you'll need to **explicitly tell** the AI to use admonitions in order for it to use them—by default LLMs don't typically output admonitions unless told to.  For example, you could create a profile and add *"Use `> [!TYPE]` admonitions in your responses when appropriate."*

However, in the near future we plan on making a more intuitive UI for enabling the model to use these and other markdown features.  Imagine a toggle or checkbox labeled "Use admonitions" in a dropdown labeled "Additional markdown features," for example.

## Color swatches

When you or the model uses a hex, HSL, or RGB color in a message, Piebald automatically detects it and displays a small color swatch of that color next to the text.

<img class="shadow-md rounded-xl" width="500" alt="color_swatches_in_user_and_ai_msg.png" src="https://mintcdn.com/piebald/fyeqsH_2V9kEw196/imgs/color_swatches_in_user_and_ai_msg.png?fit=max&auto=format&n=fyeqsH_2V9kEw196&q=85&s=7faa230a5613970e7a99ca7a674bcca1" data-path="imgs/color_swatches_in_user_and_ai_msg.png" />
