

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在主控台中使用 Markdown
<a name="aws-markdown"></a>

中的某些服務 AWS 管理主控台，例如 Amazon CloudWatch，支援在特定欄位中使用 [Markdown](https://en.wikipedia.org/wiki/Markdown)。此主題說明主控台中支援的 Markdown 格式類型。

**Topics**
+ [段落、行距和水平線](#aws-markdown-paragraphs)
+ [標題](#aws-markdown-headings)
+ [文字格式](#aws-markdown-formatting)
+ [連結](#aws-markdown-links)
+ [清單](#aws-markdown-lists)
+ [表格和按鈕 (CloudWatch 儀表板)](#aws-markdown-tables)

## 段落、行距和水平線
<a name="aws-markdown-paragraphs"></a>

段落是以空白行分隔。若要確保轉換為 HTML 後段落之間的空白行能順利呈現，請先加入含有非中斷空格的新行 (`&nbsp;`)，再加上空白行。重複加入這兩行即可連續插入多個空白行，如以下範例所示：

```
&nbsp;
     
&nbsp;
```

若要建立用於分隔段落的水平線，請加入包含連續三個連字號的新行：`---`

```
Previous paragraph.
---
Next paragraph.
```

若要建立等寬類型的文字區塊，請在一行內輸入連續三個反引號 (`)，接著輸入要以等寬類型顯示的文字，再加入包含三個反引號的新行。下方為以等寬類型格式顯示文字的範例：

```
```
This appears in a text box with a background shading.
The text is in monospace.
```
```

## 標題
<a name="aws-markdown-headings"></a>

如要建立標題，請使用井字號 (\$1)。單一井字號加上空格代表頂層標題，使用兩個井字號可建立第二層標題，使用三個井字號則可建立第三層標題。以下範例分別顯示如何建立頂層、第二層、第三層標題：

```
 # Top-level heading
```

```
 ## Second-level heading
```

```
 ### Third-level heading
```

## 文字格式
<a name="aws-markdown-formatting"></a>

若要將文字格式設為斜體，請在文字兩側分別輸入一個底線 ( \$1 ) 或星號 (\$1)。

```
*This text appears in italics.*
```

若要將文字格式設為粗體，請在文字兩側輸入兩個底線或兩個星號。

```
**This text appears in bold.**
```

若要為文字加上刪除線，請在文字兩側分別輸入兩個波狀符號 (\$1)。

```
~~This text appears in strikethrough.~~
```

## 連結
<a name="aws-markdown-links"></a>

若要加入文字超連結，請用方括號 ([ ]) 括住連結文字，後面再加上用括號 (( )) 括住的完整 URL，如以下範例所示：

```
Choose [link_text](http://my.example.com).
```

## 清單
<a name="aws-markdown-lists"></a>

若要將數行的格式設定為項目符號清單，請在各行的開頭輸入單一星號 (\$1)，再加上一個空格，如以下範例所示：

```
Here is a bulleted list:
* Ant
* Bug
* Caterpillar
```

若要將數行的格式設定為編號清單，請在各行的開頭輸入數字，再加上一個空格和一個半型句號 (.)，如以下範例所示：

```
Here is a numbered list:
1. Do the first step
2. Do the next step
3. Do the final step
```

## 表格和按鈕 (CloudWatch 儀表板)
<a name="aws-markdown-tables"></a>

CloudWatch 儀表板文字小工具支援 Markdown 資料表和按鈕。

若要建立資料表，請使用垂直線 (\$1) 區隔資料欄，並使用新行加入資料列。若要將第一行設為標題行，請在標題行和第一行的值之間插入一行，然後為資料表中每個資料欄輸入至少三個連字號 (-)，並使用垂直線分隔各個資料欄。以下範例示範如何使用 Markdown 建立包含兩個資料欄、一個標題行及兩個資料行的資料表：

```
Table | Header
----|-----
Amazon Web Services | AWS
1 | 2
```

使用上方範例提到的 Markdown 文字，可建立下方資料表：


| 資料表 | 標頭 | 
| --- | --- | 
|  Amazon Web Services  |  AWS  | 
|  1  |  2  | 

在 CloudWatch 儀表板文字小工具中，您也可以將超連結設為按鈕格式。若要建立按鈕，請使用 `[button:Button text]`，其後再加上用括號 (( )) 括住的完整 URL，如以下範例所示：

```
[button:Go to AWS](http://my.example.com) 
[button:primary:This button stands out even more](http://my.example.com)
```