---
title: TO_MARKDOWN_LIST
url: https://www.tines.com/stories/docs/formulas/functions/to-markdown-list/
kind: formula-function
---

*[tines.com](https://www.tines.com/llms.txt) › [Docs](https://www.tines.com/stories/docs/llms.txt) › [Formulas](https://www.tines.com/llm/stories/docs/formulas.md) › [Functions](https://www.tines.com/llm/stories/docs/formulas/functions.md)*

# TO_MARKDOWN_LIST

*[View on tines.com](https://www.tines.com/stories/docs/formulas/functions/to-markdown-list/)*

Format an array as a markdown list, bulleted by default and numbered when ordered is TRUE. Whitespace within an item is collapsed, because a newline would end the item and start an unmarked paragraph. An empty array returns an empty string.

**Categories:** Text

## Syntax

```
TO_MARKDOWN_LIST(array, [ordered: FALSE])
```

## Examples

### Example 1

Input:

```json
{
  "my_action": {
    "steps": [
      "Triage the alert",
      "Contain the host"
    ]
  }
}
```

Formula:

```
TO_MARKDOWN_LIST(my_action.steps)
```

Output:

```json
"- Triage the alert\n- Contain the host"
```

### Example 2: Set ordered to TRUE for a numbered list. It defaults to FALSE.

Input:

```json
{
  "my_action": {
    "steps": [
      "Triage the alert",
      "Contain the host"
    ]
  }
}
```

Formula:

```
TO_MARKDOWN_LIST(my_action.steps, ordered: TRUE)
```

Output:

```json
"1. Triage the alert\n2. Contain the host"
```