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

markdown_logo

目錄


前言

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


語法 Syntax

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

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

1. 標題的表示方法

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

方法一:

一級標題
===============
二級標題
---------------

在 Forum 中的展示效果如下:

方法二:

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

在 Forum 中的展示效果如下:

2. 段落的表示方法

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

---

在 Forum 中展示效果如下:


當段落中有重要的信息需要突出, markdown 中也提供了 粗體 斜體 引用的相關語法, 例如:

 **這裏是粗體** 

*這裏是斜體*

> 引用他人的文字

在 Forum 中展示效果如下:
image

3. 列表的表示方法

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

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

在 Forum 中展示效果如下:
image
而在文字前面加上數字則可以產生有序列表, 例如:

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

在 Forum 中展示效果如下:
image


二. Markdown 超鏈接

1. 網頁鏈接

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

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

在 Forum 中展示效果如下:
image

2. 圖片鏈接

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

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

在 Forum 中展示效果如下:


三. Markdown 表格

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

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

在 Forum 中展示效果如下:
image
從展示效果中我們不難發現:

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

四. 代碼引用

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

  • 單行代碼
    image
    在 Forum 中展示效果如下:
    image

  • 多行代碼
    image
    在 Forum 中展示效果如下:
    image


後記

在Ameba論壇的網頁端中,并非所有的Markdown語法都可以完全被支持. 本文中只列出了筆者經常使用的部分語法. 同理, GitHub, Notion, HackMD 等支持 Markdown 語法的軟件或者平臺所能支持的語法也會有差異. 如果想瞭解其他平臺能支持的 Markdown 語法, 建議前往閲讀 MarkDown+HackMD新手教學 .

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

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

1 Like