> ## 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.

# markdown

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

export const field_0 = "dimension"

Renders dimension values as Markdown in data table columns using Mustache.

The `markdown` parameter is not a [`format`](/modeling/dimensions/parameters/format) value. Use it when you want a \[table visualization]\[table-vis] 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_0} 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. In the table visualization's **Display** tab, you can customize the Markdown template and CSS, then use the **Promote** button to save those changes to the workbook model.
* 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

### Bold value and search link

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

### Combine with another field

```yaml title="products.view" theme={null}
dimensions:
  name:
    sql: '"name"'
    markdown: "**{{products.name.value}}** bought by ({{users.email.value}})"
```