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

<AgentInstructions>

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback:

POST https://docs.omni.co/feedback

```json
{
  "path": "/modeling/dimensions/parameters/markdown",
  "feedback": "Description of the issue"
}
```

Only submit feedback when you have something specific and actionable to report.

</AgentInstructions>

# markdown

> Mustache template that renders dimension values as Markdown in data table columns.

The `markdown` parameter is **not** a [format](/modeling/dimensions/parameters/format) value. Use it when you want the **data table** visualization to render a column as **Markdown** (for example bold text, links, or images) using a [Mustache](/visualize-present/mustache-reference) template filled with each row's values.

* **`format`** controls standard number, currency, and date display for the field.
* **`markdown`** renders a Mustache template as formatted text (bold, links, images) in **table** cells.

## Syntax

```yaml theme={null}
<dimension_name>:
  markdown: "<mustache_template>"
```

## Properties

<ParamField path="dimension_name" type="object">
  The name of the dimension.

  <Expandable title="dimension_name properties" defaultOpen="true">
    <ParamField path="markdown" type="string">
      A Mustache template string. The rendered output displays as Markdown in data table columns.
    </ParamField>
  </Expandable>
</ParamField>

## Behavior

* When you add a field with `markdown` to a query and use a **Table** chart, Omni merges the template into the column's display settings so cells render as Markdown by default.
* Mustache can reference **`{{value}}`**, **`{{raw}}`**, and **`{{value_url_encoded}}`** for the current field, and **`{{view_name.field_name.value}}`** (and related properties) for other fields in the row.
* Referenced fields are included in the query automatically when needed.

For how `format` and `markdown` interact, see the [Formatting values guide](/modeling/models/format-values#formats-with-markdown).

<Note>
  Dashboard **text tiles** and standalone **Markdown** chart types are separate from field `markdown`, which applies to **workbook data tables** for modeled fields.
</Note>

## Examples

```yaml title="Bold value and search link" theme={null}
dimensions:
  state:
    sql: '"state"'
    markdown: "**{{value}}** — [Search](https://example.com/search?q={{value_url_encoded}})"
```

```yaml title="Combine with another field" theme={null}
dimensions:
  name:
    sql: '"name"'
    markdown: "**{{value}}** ({{users.email.value}})"
```