> For the complete documentation index, see [llms.txt](https://docs.borndigital.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.borndigital.ai/for-advanced-users/conversation-design-tips/customizing-text-output.md).

# Customizing text output

Format chat messages with Markdown: bold text, lists, links, images, tables and more – and what the DA Bubble shows.

The **Text** of a [Message node](/digital-agent/conversation-flow/nodes-explained/message-node.md) – and the answers of an AI node in chat – can be formatted with **Markdown**, a simple way to mark up plain text. Write the marks directly into the text; the Message node editor has no formatting toolbar or shortcuts.

For the voice channel, write the **Speech** separately (turn on **Split**) – Markdown is not read out. See [Customizing speech synthesis](/for-advanced-users/conversation-design-tips/customizing-speech-synthesis.md).

## What the DA Bubble shows

| Formatting    | Write                                                                | Result in the DA Bubble                                         |
| ------------- | -------------------------------------------------------------------- | --------------------------------------------------------------- |
| Bold          | `**bold**`                                                           | **bold**                                                        |
| Italic        | `*italic*`                                                           | *italic*                                                        |
| Strikethrough | `~~old price~~`                                                      | ~~old price~~                                                   |
| Underline     | `<u>underlined</u>`                                                  | underlined text (Markdown has no underline; `__text__` is bold) |
| Heading       | `### Opening hours`                                                  | a heading (levels 1–6)                                          |
| Line break    | a new line                                                           | a new line – one Enter is enough                                |
| Bulleted list | `- item` (or `*`, `+`)                                               | a bulleted list; indent items for a nested list                 |
| Numbered list | `1. item`                                                            | a numbered list, starting with the number you write             |
| Link          | `[our website](https://borndigital.ai)`                              | a link; links to other websites open in a new tab               |
| Image or GIF  | `![Our branch](https://example.com/branch.jpg)`                      | the image                                                       |
| Video         | a YouTube link or a link to an `.mp4` / `.webm` file on its own line | an embedded video                                               |
| Inline code   | the text between two backticks                                       | monospaced text                                                 |
| Code block    | the text between two lines of three backticks                        | a monospaced block                                              |
| Table         | see below                                                            | a table, with column alignment                                  |
| Divider       | `---` on its own line                                                | a horizontal line                                               |
| Quote         | `> text`                                                             | a quotation block                                               |
| Emoji         | 😊 (paste the character)                                             | the emoji                                                       |

**Not supported** in the DA Bubble: checklists (`- [ ]` shows as a plain bullet), footnotes (`[^1]`), link titles (`[text](https://example.com "title")`) and image sizes (`=300x200`).

{% hint style="info" %}
A few HTML tags are allowed for what Markdown cannot do: `<u>`, `<sup>`, `<sub>`, `<br>` and `<span>` with a colour, alignment or font style. Other HTML tags are removed and only their text is shown.
{% endhint %}

## Examples

{% code title="Lists" %}

```
You can pay your invoice:
1. by bank transfer,
2. by card in the app,
   - Visa
   - Mastercard
3. at any branch.
```

{% endcode %}

{% code title="Link and image" overflow="wrap" %}

```
Find the nearest branch on [our map](https://example.com/branches).
![Branch opening hours](https://example.com/opening-hours.png)
```

{% endcode %}

{% code title="Table" %}

```
| Tariff | Data   | Price |
| :----- | :----: | ----: |
| Basic  | 5 GB   | €10   |
| Plus   | 20 GB  | €15   |
```

{% endcode %}

The colons in the second line align the column: `:---` left, `:---:` centre, `---:` right.

## Tips

* **Images and GIFs** must be publicly reachable – use the URL of the file itself (right-click the image › *Copy image address*), not of the page it is on.
* **Keep messages short.** A table or a long list is hard to read in a small chat window, especially on a phone.
* **Variables** work inside Markdown, for example `Your order **{order_id}** is on its way.`
* **Older bubble.** The legacy bubble supports checklists, footnotes and link titles, but not underline or other HTML tags. If you still use it, test the formatting there.
