仪表板中的Markdown很有趣

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

开发有效仪表板通常包括为人们提供上下文，让他们了解计算是如何存在或为什么存在的。虽然精确的标题、描述和带标签的轴可以在很大程度上澄清可视化，但Metabase还允许您向仪表板添加灵活的文本框。本文将向您展示如何使用Markdown语法。

向仪表板添加文本

选择要添加文本的仪表板，然后单击铅笔图标编辑仪表板。单击文本框按钮（显示为Aa). 将出现一个文本框，您可以像在问题盒子。要调整文本框的大小，请单击并拖动其右下角。

在文本框中写入

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

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

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

Metabase中的文本编辑器使用一种称为Markdown的轻量级标记语言。如果您以前从未使用过Markdown，则需要一些时间来适应，但您很快就会学会欣赏它的简单性。Markdown可以让编写者感觉像程序员和代码编写人员感到宾至如归。

Markdown的工作原理

你写了一行Markdown：

#标题

Metabase将您的纯文本转换为格式化的HTML代码。

在标题
在

在

呈现如下：

标题

你可以通过添加更多的标题来访问六个级别的标题#美国。

#标题1##标题2###标题3####标题4#####标题5######标题6

哪个Metabase呈现为：

您可以使用Markdown语法添加链接、图像、gif、列表、代码块、块引号等。下面是一个文本框，其中包含标题、段落、块引号和代码块：

您可以使用Metabase中的文本框来完成这篇文章所做的一切，甚至更多。Markdown最大的好处是您不必编写乏味的HTML，而且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

假设分析人员提供了一些上下文、代码和联系信息：但是您可以包括任何有助于阅读报告的上下文。

注意：在上面的示例中，分析人员粘贴了查询编辑器供参考。您可以查看由查询编辑器点击编辑器图标到“查看SQL”在编辑模式下。

您也可以将文本框用作简单的分隔符，以保持仪表板的组织性。

最后一个GIF爱好者的专业提示

图像语法，

![image description](image-link)

也适用于gif图片格式。因为仪表板文本框有更重要的用例：

Markdown快乐！

Metabase中文社区