markdown文件編寫

weixin_34236869發表於2018-08-29

Markdown是一種可以使用普通文字編輯器編寫的標記語言,通過簡單的標記語法,它可以使普通文字內容具有一定的格式。Markdown的語法簡潔明瞭、學習容易,而且功能比純文字更強,因此有很多人用它寫部落格。

7389101-56dda4f7cbc85184.png
markdown快捷鍵

文字樣式

標題

Markdown 支援兩種標題的類 atx 形式

類 Atx 形式則是在行首插入 1 到 6 個 # ,對應到標題 1 到 6 階,例如:

# 這是 H1

## 這是 H2

###### 這是 H6

區塊引用 Blockquotes

Markdown 標記區塊引用是使用> 的引用方式,在 Markdown 檔案中建立一個區塊引用,那會看起來像是你自己先斷好行,然後在每行的最前面加上 > ;Markdown 也允許只在整個段落的第一行最前面加上 > ;區塊引用可以巢狀(例如:引用內的引用),只要根據層次加上不同數量的 > 。

> This is the first level of quoting.

>

> > This is nested blockquote.

>

> Back to the first level.

列表

Markdown 支援有序列表和無序列表。無序列表使用星號、加號或是減號作為列表標記:

* Red

*  Green

*  Blue

有序列表則使用數字接著一個英文句點,很重要的一點是,在列表標記上使用的數字並不會影響輸出的 HTML 結果:

3. Bird

1. McHale

8. Parish

列表專案可以包含多個段落,每個專案下的段落都必須縮排 4 個空格或是 1 個製表符,也允許只是段前縮排4個空格或一個製表符,如果要在列表專案內放進引用,那 > 就需要縮排。

程式碼區塊

新增內嵌程式碼可以使用一對回勾號 `alert('Hello World')`.對於插入程式碼, Ghost支援標準的Markdown程式碼和GitHub Flavored Markdown (GFM)  。標準Markdown基於縮排程式碼行或者4個空格位或是 1 個製表符就可以,一個程式碼區塊會一直持續到沒有縮排的那一行(或是檔案結尾)。

GFM 使用三個回勾號```

```swift高亮顯示

分隔線

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

***

*****

- - - - - -

區段元素

連結

Markdown 支援兩種形式的連結語法: 行內式和參考式兩種形式

要建立一個行內式的連結,只要在方塊括號後面緊接著圓括號並插入網址連結即可,如果你還想要加上鍊接的 title 文字,只要在網址後面,用雙引號把 title 文字包起來即可,例如:

This is [an example](http://example.com/ "Title") inline link.

參考式的連結是在連結文字的括號後面再接上另一個方括號,而在第二個方括號裡面要填入用以辨識連結的標記:

[foo]: http://example.com/ "Optional Title Here"

[foo]: http://example.com/  'Optional Title Here'

[foo]: http://example.com/  (Optional Title Here)

強調

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

*single asterisks*

_single underscores_

但是如果 * 和 _ 兩邊都有空白的話,它們就只會被當成普通的符號。

圖片

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"

自動連結

Markdown 支援以比較簡短的自動連結形式來處理網址和電子郵件信箱,只要是用方括號包起來, Markdown 就會自動把它轉成連結。一般網址的連結文字就和連結地址一樣,例如:

<http://www.baidu.com>

反斜槓

Markdown 支援以下這些符號前面加上反斜槓來幫助插入普通的符號:

\ 反斜線;

`  反引號

*  星號

_  底線

{}  花括號

[]  方括號

()  括弧

#  井字號

+  加號

-  減號

.  英文句點

!  驚歎號

相關文章