仪表板中的Markdown

构建有效的仪表板通常涉及为人们提供背景信息，以使他们能够了解计算是如何或为什么存在的。虽然精确的标题、描述和标记轴可以极大地帮助你澄清可视化，但Metabase还允许你在仪表板上添加灵活的文本框。本文将向你展示如何利用Markdown语法充分利用这一功能。

向仪表板添加文本

选择你想要添加文本的仪表板，然后点击铅笔图标以编辑仪表板。在仪表板工具栏中点击文本框按钮（显示为Aa）。会出现一个文本框，你可以像移动问题框一样移动它。要调整文本框大小，请点击并拖动其右下角。

在文本框中编写

要与文本框交互，你需要在仪表板中处于编辑模式。点击仪表板右上角的仪表板工具栏中的铅笔图标。

Metabase中的文本框有两种模式。

• 编辑文本（铅笔图标）。
• 渲染视图（眼睛图标）。

Metabase中的文本编辑器使用一种轻量级的标记语言，称为Markdown。如果你以前从未使用过Markdown，可能需要一段时间才能习惯，但很快你将学会欣赏它的简单性。Markdown可以让作者感觉像程序员，而程序员则感觉宾至如归。

Markdown是如何工作的

要创建不同级别的标题，如下所示

你需要编写

# Heading 1

## Heading 2

### Heading 3

#### Heading 4

##### Heading 5

###### Heading 6

纯文本## 标题2被渲染为HTML代码

<h2>
  Heading
  <h2></h2>
</h2>

你可以使用Markdown语法添加链接、图片、GIF、列表、代码块、引用块等。这里有一个包含标题、段落、引用块和代码块的文本框

你可以在Metabase中使用文本框做本文所做的一切，以及更多。Markdown的妙处在于你不必编写繁琐的HTML，Markdown在Metabase渲染之前就是可读的。Markdown的最简特性集将帮助你专注于内容，并在你的仪表板上提供统一的风格。

你可以在这个指南中了解更多关于Markdown语法的知识，以及从Markdown的原始创作者之一那里了解，该指南还包括Markdown背后的理念。作为额外的好处，该网站允许你以Markdown语法查看其内容在这里。

示例文本框

以下是一个包含问题和文本框的示例仪表板

以下是上面文本框中使用的Markdown代码

# Analysis

Although `Gadgets` outsold `Gizmos` in 2019, we only introduced `Gizmos` and `Doohickeys` in September of 2019. Additionally, both `Gadgets` and `Widgets` were heavily discounted during our spring, summer, and holiday sales.

We expect sales to continue to grow in the `Gizmo` and `Doohickey` product lines.

# SQL query

    SELECT "PRODUCTS__via__PRODUCT_ID"."CATEGORY" AS "CATEGORY",
    sum("PUBLIC"."ORDERS"."QUANTITY") AS "sum"
    FROM "PUBLIC"."ORDERS"
    LEFT JOIN "PUBLIC"."PRODUCTS" "PRODUCTS__via__PRODUCT_ID" ON
    "PUBLIC"."ORDERS"."PRODUCT_ID" = "PRODUCTS__via__PRODUCT_ID"."ID"
    WHERE ("PUBLIC"."ORDERS"."CREATED_AT" >= timestamp with time zone '2019-01-01 00:00:00.000Z'
    AND "PUBLIC"."ORDERS"."CREATED_AT" < timestamp with time zone '2020-01-01 00:00:00.000Z')
    GROUP BY "PRODUCTS__via__PRODUCT_ID"."CATEGORY"
    ORDER BY "sum" ASC, "PRODUCTS__via__PRODUCT_ID"."CATEGORY" ASC

# Contact

If you have questions, reach out to us on the [\#product](https://fakemessageservice.com/product) channel.

假设分析师提供了一些背景、代码和联系信息：但你可以根据需要包含任何有助于报告读者的背景信息。

注意：在上面的示例中，分析师粘贴了查询构建器生成的原始SQL查询以供参考。在编辑模式下，您可以通过点击编辑器图标来“查看SQL”，查看查询构建器组成的SQL。

您还可以使用文本框作为简单的分隔符，以保持仪表板的组织。

在文本卡片中使用变量创建动态文本

您可以将变量添加到文本卡片中，并将它们连接到过滤器。Metabase将取过滤器中选择的值，并将这些值插入到您的文本中的变量中，创建在人们更改过滤器值时自动更新的文本卡片。

例如，假设您想要在文本卡片中显示仪表板上的计划过滤器的值，如下所示

文本卡片中列出的计划将根据过滤器中选择的计划而改变（在这种情况下，过滤器中选择了商业和高级计划，因此文本卡片显示了它们）。

将文本卡片变量连接到过滤器

1. 单击铅笔图标以进入仪表板编辑模式。
2. 向您的仪表板添加过滤器。
3. 向您的仪表板添加文本卡片。

4. 编写一些Markdown并包含一个变量。变量用双大括号括起来

   # Plan
   ## {{PLAN}}
   

5. 将过滤器连接到文本卡片中的变量。

如果未将值插入到过滤器中，Metabase将渲染难看的{{PLAN}}变量。为了处理过滤器没有值的情况，您可以设置默认值，或者更好的方法是用双括号包围变量文本，使文本可选。

# Plan
[[## {{PLAN}}]]

双括号告诉Metabase仅在连接的过滤器至少有一个值时显示文本。

使用过滤器值创建自定义URL

您可以将以下URL添加到Markdown卡片中

[Google Search](https://google.com)

这将显示为可点击的超链接：Google搜索。

要创建一个动态URL，例如“filter_value”的Google搜索，您可以在需要显示过滤器值文本的地方放置一个{{variable}}。例如，要将动态URL添加到包含发票表的仪表板中

1. 为“计划”创建仪表板过滤器。

2. 添加包含您的URL和变量的Markdown卡片

   [[ [Google Search for "{{plan}}"](https://google.com/search?q={{plan}}) ]]
   

3. 将“计划”过滤器连接到Markdown卡片.
4. 可选：为“计划”过滤器设置默认值。

Markdown卡片文本中的外层双大括号将在过滤器为空（未选择值且未设置默认值）时默认隐藏URL。

现在，如果有人进入“计划”过滤器并选择“基本”，他们将看到Markdown卡片中的如下可点击链接：“基本”的Google搜索。

具有沙盒属性的自定义URL

假设您有一个“部门”属性，您想要创建一个指向用户指南的自定义链接，如下所示

[View Marketing guide](https://your-company-wiki.com/marketing)

要基于个人的沙盒属性显示自定义URL

1. 为沙盒属性创建仪表板过滤器。

2. 添加包含您的URL和变量的Markdown卡片

   [[ [View {{department}} guide](https://your-company-wiki.com/{{department}}) ]]
   

3. 将过滤器连接到Markdown卡片.

要默认隐藏URL，当过滤器值为空时，请确保在Markdown卡片文本中包含外层双大括号。

当沙盒用户查看仪表板时，他们会看到

• 查看营销指南.
• 一个值为“营销”（没有其他可选选项）的过滤器小部件。
• 仪表板数据在“部门 = 营销”的行上进行了行级沙盒化。

如果你的仪表板是静态嵌入，你可以选择隐藏筛选小部件。

最后一个小技巧，献给GIF爱好者

图像语法

![image description](image-link)

也适用于GIF。因为仪表板文本框有更多重要的用途案例

享受Markdown吧！