儀表板中的 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，例如 「篩選器值」的 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 愉快！