markdown語法

段落與換行

換行最好在前一段字符串後加兩個空格
兩行之間不管有多少空行,顯示都是一個空行
唯一決定兩行文字是否是段落的,就在於這兩行文字之間是否有空行
段落也可以用p標籤表示

標題

用1-6個#表示一到六階標題,可以在標題前加#,也可以前後都加

分割線

你可以在一行中用三個以上的星號、減號、底線來建立一個分隔線,行內不能有其他東西。你也可以在星號或是減號中間插入空格

** 注意 **

  • atom底線未生效,建議用其他兩種

區塊引用

用>表示區塊引用,區塊引用可以用多個>表示嵌套,也可以用其他語法例如[> #]表示區塊索引內的標題
結束可以用空行

列表

無序列表使用星號、加號或是減號作爲列表標記
有序列表則使用數字接着一個英文句點

** 注意 **

  • 符號後面需要加一個空格
  • 行首出現數字-句點-空白,要避免這樣的狀況,你可以在句點前面加上反斜槓。
  • tab表示縮進一個層級,可以實現列表的嵌套

代碼區塊

用<pre><code>表示代碼區塊。
代碼區塊中,一般的 Markdown 語法不會被轉換,像是星號便只是星號

鏈接

Markdown 支持兩種形式的鏈接語法: 行內式和參考式兩種形式。

不管是哪一種,鏈接文字都是用 [方括號] 來標記。

1. 行內式:要建立一個行內式的鏈接,只要在方塊括號後面緊接着圓括號並插入網址鏈接
[百度一下](http://www.baidu.com)
2. 參考式:在鏈接文字的括號後面再接上另一個方括號,而在第二個方括號裏面要填入用以辨識鏈接的標記
[百度一下][baidu]
在文件的任意處,你可以把這個標記的鏈接內容定義出來

** 注意 **

  • 鏈接辨別標籤可以有字母、數字、空白和標點符號,但是並不區分大小寫
[baidu]:http://www.baidu.com

隱式鏈接標記:讓你可以省略指定鏈接標記,這種情形下,鏈接標記會視爲等同於鏈接文字,要用隱式鏈接標記只要在鏈接文字後面加上一個空的方括號,如果你要讓 “Google” 鏈接到 google.com

[google][]

然後定義鏈接內容

[google]: http://google.com/

強調

Markdown 使用星號(*)和底線(_)作爲標記強調字詞的符號,被 * 或 _ 包圍的字詞會被轉成用 <em> 標籤包圍,用兩個* 或 _ 包起來的話,則會被轉成 <strong>


*single asterisks*
_single underscores_
**double asterisks**
__double underscores__

** 注意 **

  • 如果你的 * 和 _ 兩邊都有空白的話,它們就只會被當成普通的符號
  • 如果要在文字前後直接插入普通的星號或底線,你可以用反斜線

代碼

如果要標記一小段行內代碼,你可以用反引號把它包起來(`)
如果要在代碼區段內插入反引號,你可以用多個反引號來開啓和結束代碼區段

圖片

Markdown 使用一種和鏈接很相似的語法來標記圖片,同樣也允許兩種樣式: 行內式和參考式。

  1. 行內式
![Alt text](/path/to/img.jpg)
  1. 參考式
![Alt text][id]

「id」是圖片參考的名稱,圖片參考的定義方式則和鏈接參考一樣

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

** 注意 **

  • Markdown 還沒有辦法指定圖片的寬高,如果你需要的話,你可以使用普通的 <img> 標籤。

java代碼

使用如下格式寫java代碼


```java
public class Example {
  public static void main(String[] args) {

  }
}
```

表格

** 語法說明 **

  • |、-、:之間的多餘空格會被忽略,不影響佈局。
  • 默認標題欄居中對齊,內容居左對齊。
  • -:表示內容和標題欄居右對齊,:-表示內容和標題欄居左對齊,:-:表示內容和標題欄居中對齊。
  • 內容和|之間的多餘空格會被忽略,每行第一個|和最後一個|可以省略,-的數量至少有一個。

| 左對齊標題 | 右對齊標題 | 居中對齊標題 |
| :------| ------: | :------: |
| 短文本 | 中等文本 | 稍微長一點的文本 |
| 稍微長一點的文本 | 短文本 | 中等文本 |

** 注意 **

  • 表格的語句上一行必須爲空行,不然表格不生效。
一個普通標題 一個普通標題 一個普通標題
短文本 中等文本 稍微長一點的文本
稍微長一點的文本 短文本 中等文本
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章