Markdown 語法介紹

Markdown 是一種輕量級標記語言，讓寫作者專注於寫作而不用關注樣式。Coding 的許多版塊均採用了 Markdown 語法，比如冒泡、討論、Pull Request 等。

標題

用 Markdown 書寫時，只需要在文字前面加上『# 』即可建立一級標題。同理，建立二級標題、三級標題等只需要增加『# 』個數即可，Markdown 共支援六級標題。如下所示：

# 一級標題
## 二級標題
### 三級標題
#### 四級標題
##### 五級標題
###### 六級標題

點選預覽可以看到效果：

錨點

Coding 會針對每個標題，在解析時都會新增錨點 id，如

# 錨點

會被解析成：

<h1 id="user-content-錨點">錨點</h1>

注意我們添加了一個 user-content- 的字首，所以如果要自己新增跳轉連結要使用 Markdown 的形式，且連結要加一個 user-content- 字首，如：

[訪問連結](#user-content-錨點);

引用

Markdown 標記區塊引用和 email 中用 『>』的引用方式類似，只需要在整個段落的第一行最前面加上 『>』 ：

> Coding.net 為軟體開發者提供基於雲端計算技術的軟體開發平臺，包括專案管理，程式碼託管，執行空間和質量控制等等。

效果圖如下：

區塊引用可以巢狀，只要根據層次加上不同數量的『>』：

> 這是第一級引用。
>
> > 這是第二級引用。
>
> 現在回到第一級引用。

效果圖如下：

引用的區塊內也可以使用其他的 Markdown 語法，包括標題、列表、程式碼區塊等：

> ## 這是一個標題。
> 1. 這是第一行列表項。
> 2. 這是第二行列表項。
>
> 給出一些例子程式碼：
>
> return shell_exec(`echo $input | $markdown_script`);

效果圖如下：

列表

列表專案標記通常放在最左邊，專案標記後面要接一個字元的空格。

無序列表：使用星號、加號或是減號作為列表標記

- Red
- Green
- Blue

效果圖如下：

有序列表：使用數字接著一個英文句點

1. Red
2. Green
3. Blue

效果圖如下：

如果要在列表專案內放進引用，那『>』就需要縮排：

*  Coding.net有以下主要功能:
    > 程式碼託管平臺
    > 線上執行環境    
    > 程式碼質量監控    
    > 專案管理平臺

效果圖如下：

代辦列表: 表示列表是否勾選狀態（注意：[ ] 前後都要有空格）

- [ ] 不勾選
- [x] 勾選

效果圖如下：

程式碼

只要把你的程式碼塊包裹在 “` 之間，你就不需要通過無休止的縮排來標記程式碼塊了。 在圍欄式程式碼塊中，你可以指定一個可選的語言識別符號，然後我們就可以為它啟用語法著色了。 舉個例子，這樣可以為一段 Ruby 程式碼著色：

```ruby
require 'redcarpet'
markdown = Redcarpet.new("Hello World!")
puts markdown.to_html
```

效果圖如下：

強調

在Markdown中，可以使用 * 和  _  來表示斜體和加粗。

斜體：

*Coding，讓開發更簡單*
_Coding，讓開發更簡單_

效果圖如下：

加粗：

**Coding，讓開發更簡單**
__Coding，讓開發更簡單__

效果圖如下：

自動連結

方括號顯示說明，圓括號內顯示網址， Markdown 會自動把它轉成連結，例如：

[超強大的雲開發平臺Coding](http://coding.net)

效果圖如下：

表格

在 Markdown 中，可以製作表格，例如：

First Header | Second Header | Third Header
------------ | ------------- | ------------
Content Cell | Content Cell  | Content Cell
Content Cell | Content Cell  | Content Cell

效果圖如下：

或者也可以讓表格兩邊內容對齊，中間內容居中，例如：

First Header | Second Header | Third Header
:----------- | :-----------: | -----------:
Left         | Center        | Right
Left         | Center        | Right

效果圖如下：

分割線

在 Markdown 中，可以使用 3 個以上『-』符號製作分割線，例如：

這是分隔線上部分內容
---
這是分隔線上部分內容

效果圖如下：

圖片

Markdown 使用了類似連結的語法來插入圖片, 包含兩種形式: 內聯 和 引用.

內聯圖片語法如下:

![Alt text](/path/to/img.jpg)
或
![Alt text](/path/to/img.jpg "Optional title")

也就是:

• 一個驚歎號『!』
• 接著一個方括號，裡面是圖片的替代文字
• 接著一個普通括號，裡面是圖片的網址，最後還可以用引號包住並加上 選擇性的『title’』文字。

引用圖片語法如下:

![Alt text][id]

『id』 是圖片引用的名稱. 圖片引用使用連結定義的相同語法:

[id]: url/to/image "Optional title attribute"