# 【分享】AmebaIoT 論壇支持的 Markdown 語法概覽

**URL:** <https://forum.amebaiot.com/t/amebaiot-markdown/746>\
**Category:** General\
**Created:** [August 19, 2021, 7:53am UTC](https://forum.amebaiot.com/t/amebaiot-markdown/746 "2021-08-19T07:53:47Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![dakamaster](https://sea2.discourse-cdn.com/flex016/user_avatar/forum.amebaiot.com/dakamaster/32/3588_2.png) [@dakamaster](https://forum.amebaiot.com/u/dakamaster)\
**Post date:** [August 19, 2021, 7:53am UTC](https://forum.amebaiot.com/t/amebaiot-markdown/746/1 "2021-08-19T07:53:47Z")

</div>

![markdown_logo](https://us1.discourse-cdn.com/flex016/uploads/ameba/original/1X/0c33b1a78d9203219dc5614087265d6eff792425.jpeg)

## 目錄

- 前言
- 語法 Syntax
  - 一. Markdown 標題, 段落以及列表
    - 1. 標題的表示方法
    - 2. 段落的表示方法
    - 3. 列表的表示方法

  - 二. Markdown 超鏈接
    - 1. 網頁鏈接
    - 2. 圖片鏈接

  - 三. Markdown 表格
  - 四. 代碼引用

- 後記

* * *

## 前言

這篇文章主要是爲了承接上一篇 : [【分享】什麽是Markdown？要如何使用它？（1）](https://forum.amebaiot.com/t/markdown-1/514) 的内容。簡單回顧一下，上一次我們介紹了什麽是 “markdown”, 它的優缺點以及目前可以使用的平臺。雖然markdown是“標記語言”，但是千萬別被這個名字嚇到了，Markdown的語法十分簡單，常用的標記符號不超過10個。用於日常寫作記錄綽綽有餘，讀完這篇文章就能完全掌握markdown相關的語法。讓我們來一起看看這10個不到的標記符號是如何讓人優雅地沉浸式記錄，專注内容而不是糾結排版，達到“不用動鼠標就可以打出漂亮文章”的境界。

* * *

## 語法 Syntax

關於 Markdown 的語法部分，主要會從我比較常用的幾個説起，分別是 `一、標題段落以及列表` ， `超鏈接` ，以及 `表格`

### 一、Markdown 標題, 段落以及列表

#### 1. 標題的表示方法

Markdown 標題主要有兩種語法表達方式：

#### 方法一:

```markdown
一級標題
===============
二級標題
---------------

```

在 Forum 中的展示效果如下：

 ![image](https://us1.discourse-cdn.com/flex016/uploads/ameba/original/1X/2cf7f226ffc41f41892d8a68e5ecfb7efd87101d.png)

#### 方法二:

```markdown
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

```

在 Forum 中的展示效果如下：

 ![image](https://us1.discourse-cdn.com/flex016/uploads/ameba/original/1X/5fd11ab2a82c1d7c53c019cb3e6b877c43af82f0.png)

#### 2. 段落的表示方法

在生成標題后, 可以像在 word 中打字一樣, 輸入您需要的文字信息. 當文字信息過於冗長,影響閲讀觀感時, 可以使用 `回車鍵` 進行分段. 如果覺得這樣的分段不夠醒目, 可以使用"分割綫"的語法功能:

```markdown
---

```

在 Forum 中展示效果如下:  
 ![image](https://us1.discourse-cdn.com/flex016/uploads/ameba/original/1X/73cd73a7970f2aa9306cd9ab42a76521c9096d8e.png)  
當段落中有重要的信息需要突出, markdown 中也提供了 `粗體` `斜體` `引用`的相關語法, 例如:

```auto
 **這裏是粗體** 

*這裏是斜體*

> 引用他人的文字

```

在 Forum 中展示效果如下:

 ![image](https://us1.discourse-cdn.com/flex016/uploads/ameba/original/1X/2166bcfb1f9e06f18f81f34337dca850b089e40d.png)

#### 3. 列表的表示方法

列表格式也很常用, 在 Markdown 中, 你只需要在文字前面加上 `-` 或者 `*` 就可以產生 **無序列表** , 例如:

```markdown
- 文本一
- 文本二
- 文本三
或
* 文本一
* 文本二
* 文本三

```

在 Forum 中展示效果如下:

 ![image](https://us1.discourse-cdn.com/flex016/uploads/ameba/original/1X/db500aa33ee802d727f0da3c6f6cb66956120fbc.png)  
而在文字前面加上數字則可以產生 **有序列表** , 例如:

```markdown
1. 文本一
2. 文本二
3. 文本三

```

在 Forum 中展示效果如下:  
 ![image](https://us1.discourse-cdn.com/flex016/uploads/ameba/original/1X/683f85c333db7dea20529b281627330852d2bdea.png)

* * *

### 二. Markdown 超鏈接

#### 1. 網頁鏈接

在 Markdown 中, 插入連接不需要其他按鈕, 只需要輸入 `[顯示文本](鏈接地址)` 這樣的語法格式即可, 例如輸入:

```markdown
[Ameba官方論壇](https://forum.amebaiot.com/)

```

在 Forum 中展示效果如下:  
 ![image](https://us1.discourse-cdn.com/flex016/uploads/ameba/original/1X/8faa5b92d91db82bab25814d38522d4f5397f612.png)

#### 2. 圖片鏈接

與插入網頁鏈接相似, 插入圖片也不需要其他按鈕, 你只需要輸入 `![圖片名稱|尺寸, 縮放比例](圖片鏈接)` 這樣的語法格式即可, 例如輸入:

```markdown
![RTL8722DM|690x460, 50%](upload://wDnARafH3W7KoN2DXayporADqLN.jpeg)

```

在 Forum 中展示效果如下:

 ![RTL8722DM](https://us1.discourse-cdn.com/flex016/uploads/ameba/original/1X/e4b92c4662aa3fe1de889a1c4af515db21a20c23.jpeg)

* * *

### 三. Markdown 表格

除了文本的功能之外, Markdown 語法也支持表格的生成. 可以使用 `|` 來分隔不同單元格, 使用 `-` 來分隔表頭與内容行. 爲了美觀, 可以在表頭下方的分割綫中加入 `:` 進行内容的對齊, 例如下列代碼:

```markdown
| Tables | Amount Demo |
| :-------: | -------------------: |
| Col 1 | 1000 |
| Col 2 | 1500 |

```

在 Forum 中展示效果如下:

 ![image](https://us1.discourse-cdn.com/flex016/uploads/ameba/original/1X/43ba9bf7bb955a006862393b94d2b21db42913ee.png)  
從展示效果中我們不難發現:

- `:----` 代表左對齊
- `:---:` 代表居中
- `----:` 代表右對齊

* * *

### 四. 代碼引用

需要引用代碼是,如果只有一行代碼, 可以使用 ` 符號將代碼語句包起來. 如果要引用多行代碼,可以使用一對 ``` 分別放在代碼首行和末行前後. 舉例如下:

- **單行代碼**  
 ![image](https://us1.discourse-cdn.com/flex016/uploads/ameba/original/1X/39f4aef9c77da0897a984c527b9a502dfe58bd45.png)  
在 Forum 中展示效果如下:  
 ![image](https://us1.discourse-cdn.com/flex016/uploads/ameba/original/1X/7836565574d8f5ab214d79ea65610c89e95ae35c.png)

- **多行代碼**  
 ![image](https://us1.discourse-cdn.com/flex016/uploads/ameba/original/1X/6ef6d0ef40108de0661b4aeb64500cf00547c23a.png)  
在 Forum 中展示效果如下:  
 ![image](https://us1.discourse-cdn.com/flex016/uploads/ameba/original/1X/6899b57f2e88c56e8f8aec24ea6eea7730fc98e6.png)

* * *

### 後記

在Ameba論壇的網頁端中,并非所有的Markdown語法都可以完全被支持. 本文中只列出了筆者經常使用的部分語法. 同理, GitHub, Notion, HackMD 等支持 Markdown 語法的軟件或者平臺所能支持的語法也會有差異. 如果想瞭解其他平臺能支持的 Markdown 語法, 建議前往閲讀 [MarkDown+HackMD新手教學](https://hackmd.io/@eMP9zQQ0Qt6I8Uqp2Vqy6w/SyiOheL5N/%2FBVqowKshRH246Q7UDyodFA?type=book).

另外, 本文中提到的語法都可以在本Ameba論壇的網頁端中使用, 如果大家對 Markdown 語法感興趣, 可以在論壇中開啓新的草稿文件嘗試書寫練習. 因爲網頁提供了左側代碼,右側預覽的雙視圖模式, 可以方便初學者進行書寫練習:

 ![image](https://us1.discourse-cdn.com/flex016/uploads/ameba/original/1X/ee79fb195fa9edc50860742ad5b139bbc2e0d3c3.png)

希望這篇文章可以幫到剛開始使用 Markdown 的朋友們.