一、說明

為因應文章多樣性及無障礙考量,本站提供教學、討論與精華三區發文時使用 markdown 格式。 讓使用者在純文字書寫環境下即可產出基本樣式與使用者互動之元素。 目前本站 markdown 規則如下:

二、規則

1.斜體

說明:斜體字。

語法:用一對星號左右包夾。

範例:

我是*斜體*字

2.粗體

說明:粗體字。

語法:用二對星號左右包夾。

範例:

我是**粗體**字

3.粗體加斜體

說明:粗體字加斜體字。

語法:用三對星號左右包夾。

範例:

我是***粗體加斜體***字

4.表格

說明:產生幾欄幾列的資料表格。

語法: | 代表直線,- 代表標題與內容的分隔線,用空格將符號與資料隔開,表格上下要空行。

範例:產生三欄三列的表格

表格開始前要空行

| a | b | c |
| --- | --- | --- |
| android | book | clear |
| 三一 | 三二 | 三三 |

表格結束後要空行

補充:第二行的 --- 分格線,預設為表格欄位齊左,我們可以利用它來改變表格欄位內容對齊方式,:-- 齊左,:-: 齊中,--: 齊右 例如:

| :-- | :-: | --: | 此設定為 | 齊左 | 齊中 | 齊右 |
| :---- | :----: | ----: | 此設定為 | 齊左 | 齊中 | 齊右 |
| :- | : | -: | 此設定為 | 齊左 | 齊中 | 齊右 |
| : | : | : | 此設定為全部 齊中

5.有序清單

說明:產生有1,2,3編號的清單項目

語法:用數字開頭加小數點,點的右方必須空格,第一個項目的數字為該清單的起始編號,後序編號系統會自動加一,清單上下要空行。

範例:

清單開始前要空行

1. 你好
1. 我好
1. 大家好

清單結束後要空行

6.無序清單

說明:產生有項目符號的清單。

語法:用星號開頭,星號的右方必須空格,清單上下要空行。

範例:

清單開始前要空行

* 你好
* 我好
* 大家好

清單結束後要空行

7.標題

說明:產生各層級之大標題。

語法:標題上空一行,井號右方需空一格,幾個井號就是第幾級標題,從 1 到 6 級。

注意:

  • 教學區:開放3,4,5,6級標題
  • 討論區與精華區暫不開放此功能。

範例:

標題上空一行

### 第三級
內容

#### 第四級
內容

##### 第五級
內容

###### 第六級
內容

8.連結

說明:產生一個連結,可讓使用者直接點擊,另開視窗進入該連結。

語法:一對中括號夾住連結說明,接著一對小括號包夾連結網址。

範例:

一般連結:
[NVDA 台灣](http://www.nvda.org.tw)
加上 title 的連結:
[NVDA 台灣](http://www.nvda.org.tw "點擊連結前往該站")

9.圖片

說明:產生一張圖片,可直接在瀏覽器上顯示。

語法:以驚嘆號開頭,接一對中括號夾住圖片說明,接著一對小括號包夾圖片網址。

範例:

![NVDA 台灣Logo](http://alex.nvda.org.tw/assets/logo.png)

10.程式碼區塊

說明:該區塊之文字將照原格式輸出。

語法:以一對反引號上下包夾,程式碼區塊上下要空行。

範例:

```

def ph(): print('hello') print('world')

ph()

```

11.內嵌 youtube 影片

說明:直接內嵌 youtube 播放頁框到文章中。

語法:與連結相同,但連結網址是 youtube 影片連結。

範例:

[](https://www.youtube.com/watch?v=6mYOfCzc1xw)

12.多層清單

說明:可能是有序包無序或無序包有序清單都可以。

語法:第一層如之前清單,第二層內縮至第一層的點後面的空格之後。

範例:

* 我是無序一
* 我是無序二
  1. 我是第二層有序一
  1. 我是第二層有序二
* 我是無序三
  1. 我是第二層有序一

13.分隔線

說明:產生一條分隔線。

語法:三個連字號以上,需上下空行。

範例:

上面要空行

---

下面也要空行

補充:只要在同一行裡,至少有三個連字號,都會轉換成分隔線,以下範例皆可。

- - -
-- -
- --
-     - -           -
-                 -                    - - - - -