仪表盘中的 Markdown
如何在仪表板中使用 Markdown 来增添乐趣并获取收益。
构建有效的仪表板通常需要为人们提供上下文,让他们了解计算是如何或为何存在的。虽然精确的标题、描述和标记的轴可以极大地澄清您的可视化,但 Metabase 还允许您在仪表板中添加灵活的文本框。本文将向您展示如何使用 Markdown 语法充分利用此功能。
向仪表板添加文本
选择您要添加文本的仪表板,然后单击**铅笔图标**以编辑仪表板。单击仪表板工具栏中的**文本框**按钮(显示为 Aa
)。将出现一个文本框,您可以像移动问题框一样移动它。要调整文本框的大小,请单击并拖动其右下角。
在文本框中书写
要与文本框交互,您需要在仪表板中处于编辑模式。单击仪表板右上角仪表板工具栏中的**铅笔图标**。
Metabase 中的文本框有两种模式。
- 编辑文本(**铅笔图标**)。
- 渲染视图(**眼睛图标**)。
Metabase 中的文本编辑器采用了一种轻量级标记语言,称为 Markdown。如果您以前从未使用过 Markdown,可能需要一段时间才能适应,但您很快就会喜欢上它的简洁性。Markdown 可以让写作者感觉像程序员,让程序员感觉宾至如归。
Markdown 的工作原理
要创建不同的标题级别,例如这样
您将编写
# Heading 1
## Heading 2
### Heading 3
#### Heading 4
##### Heading 5
###### Heading 6
纯文本 ## Heading 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。
您还可以使用文本框作为简单的分隔符,以保持仪表板的组织性。
在文本卡中使用变量创建动态文本
您可以将变量添加到文本卡并将其与筛选器关联。Metabase 会获取筛选器中选定的值,并将这些值插入到文本中的变量中,从而创建当人们更改筛选器值时自动更新的文本卡。
例如,假设您希望文本卡显示仪表板中**计划**筛选器中的值,如下所示
文本卡中列出的计划将根据筛选器中选择的计划而改变(在此示例中,筛选器中选择了“商业”和“高级”计划,因此文本卡会显示它们)。
将文本卡变量与筛选器关联
- 单击**铅笔**图标进入仪表板编辑模式。
- 向仪表板添加筛选器。
- 向仪表板添加文本卡。
-
编写一些 Markdown 并包含一个变量。变量用双大括号括起来
# Plan ## {{PLAN}}
- 将筛选器连接到文本卡中的变量。
如果没有值插入到筛选器中,Metabase 将渲染出难看的 {{PLAN}}
变量。为了处理筛选器没有值的情况,您可以设置一个默认值,或者更好的是,通过用双括号将变量文本括起来使文本变为可选来隐藏文本。
# Plan
[[## {{PLAN}}]]
双括号告诉 Metabase 仅当连接的筛选器至少有一个值时才显示文本。
使用筛选器值创建自定义 URL
您可以在 Markdown 卡片中添加一个 URL,像这样
[Google Search](https://google.com)
这将显示为可点击的超链接:Google 搜索。
要创建动态 URL,例如Google 搜索“filter value”,您可以在任何需要显示筛选器值文本的位置放置 {{variable}}
。例如,要向包含**发票**表的仪表板添加动态 URL
- 为“计划”创建一个仪表板筛选器。
-
添加一个包含您的 URL 和变量的 Markdown 卡片
[[ [Google Search for "{{plan}}"](https://google.com/search?q={{plan}}) ]]
- 将“计划”筛选器连接到 Markdown 卡片.
- 可选:为“计划”筛选器设置默认值。
Markdown 卡片文本中的外部双括号将在筛选器为空时(未选择值且未设置默认值)默认隐藏 URL。
现在,如果有人转到“计划”筛选器并选择“基本”,他们将在 Markdown 卡片中看到一个可点击的链接,如下所示:Google 搜索“基本”。
给 GIF 爱好者的最后一个专业提示
图像语法,

也适用于 GIF。因为仪表板文本框有更重要的用例
祝您 Markdown 之旅愉快!