仪表盘中的 Markdown

如何在仪表盘中使用 Markdown 以获得乐趣和收益。

构建有效的仪表盘通常需要为用户提供上下文,以便他们了解计算的方式或原因。虽然精确的标题、描述和标记轴可以在很大程度上澄清您的可视化,但 Metabase 也允许您向仪表盘添加灵活的文本框。本文将向您展示如何使用 Markdown 语法充分利用此功能。

向仪表盘添加文本

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

Adding question and text box to dashboard.

在文本框中书写

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

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

  • 编辑文本(铅笔图标)。
  • 渲染视图(眼睛图标)。

Metabase 中的文本编辑器采用了一种名为 Markdown 的轻量级标记语言。如果您以前从未使用过 Markdown,可能需要一些时间来适应,但您很快就会喜欢上它的简洁性。Markdown 可以让写作者感觉自己是程序员,让程序员感觉宾至如归。

Markdown 的工作原理

要创建像这样的不同标题级别

Headings as Metabase renders them in a text card on a dashboard.

您会写

# Heading 1

## Heading 2

### Heading 3

#### Heading 4

##### Heading 5

###### Heading 6

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

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

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

Heading, paragraph, and blockquote.

您可以使用 Metabase 中的文本框完成本文所做的一切以及更多功能。Markdown 的优点在于您无需编写繁琐的 HTML,而且 Markdown 在 Metabase 渲染之前也易于阅读。Markdown 的极简功能集将使您专注于内容,并在您的仪表盘中提供标准化的外观。

您可以在此指南以及Markdown 的原始创建者之一处了解更多关于 Markdown 语法的知识,其中还包括 Markdown 背后的理念。作为奖励,该网站允许您以Markdown 语法查看其内容。

示例文本框

这是一个包含问题和文本框的示例仪表盘

Dashboard with question and text cards.

这是上面文本框中使用的 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。

您还可以使用文本框作为简单的分隔符,以保持仪表盘的整洁。

Using a text card as a divider to organize your dashboard.

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

您可以向文本卡添加变量并将其连接到筛选器。Metabase 将获取筛选器中选定的值,并将这些值插入到文本中的变量中,从而创建当人们更改筛选器值时自动更新的文本卡。

例如,假设您希望文本卡显示仪表盘中计划筛选器的值,如下所示

Metabase rendering the two plans selected in the filter,

文本卡中列出的计划将根据筛选器中选择的计划而改变(在本例中,选择了商业版和高级版计划,因此文本卡显示了它们)。

将文本卡变量连接到筛选器

  1. 点击铅笔图标进入仪表盘编辑模式。
  2. 向仪表盘添加筛选器
  3. 向仪表盘添加文本卡
  4. 编写一些 Markdown 并包含一个变量。变量用双大括号括起来

    # Plan
    ## {{PLAN}}
    
  5. 将筛选器连接到文本卡中的变量。

Adding a variable to your text card.

如果没有值插入到筛选器中,Metabase 将呈现难看的 {{PLAN}} 变量。为了处理筛选器没有值的情况,您可以设置一个默认值,或者更好的是,通过用双括号将变量文本括起来以使其可选来隐藏文本。

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

双括号告诉 Metabase 只有当连接的筛选器至少有一个值时才显示文本。

创建带有筛选器值的自定义 URL

您可以像这样向 Markdown 卡添加 URL

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

它将显示为可点击的超链接:Google 搜索

要创建动态 URL,例如Google 搜索“筛选器值”,您可以在任何需要显示筛选器值文本的地方放置一个 {{variable}}。例如,要向带有发票表的仪表盘添加动态 URL

  1. 为“计划”创建一个仪表盘筛选器。
  2. 添加一个带有您的 URL 和变量的 Markdown 卡

    [[ [Google Search for "{{plan}}"](https://google.com/search?q={{plan}}) ]]
    
  3. 将“计划”筛选器连接到 Markdown 卡.
  4. 可选:为“计划”筛选器设置默认值。

Markdown 卡文本中的外层双方括号将在筛选器为空(未选择值且未设置默认值)时默认隐藏 URL。

A custom URL that accepts a filter value.

现在,如果有人前往“计划”筛选器并选择“基本”,他们将在 Markdown 卡中看到一个可点击的链接,如下所示:Google 搜索“基本”

带有沙盒属性的自定义 URL

数据沙盒仅适用于 专业版企业版 计划(自托管和 Metabase 云)。

假设您有一个“部门”属性,并且您希望创建一个指向用户指南的自定义链接,如下所示

[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。因为仪表盘文本框有更重要的用例

One of these cards is not like the others.

祝您 Markdown 之旅愉快!

下一步:使用 Metabase 构建记录查找工具

如何使用 Metabase 构建内部查找工具,以快速查找客户、订单或其他数据的详细信息。

下一篇文章
© . All rights reserved.