MarkDown入門學習總結教程

We believe that writing is about content,about what you want to say – not about fancy formatting.
譯文:我們堅信寫作寫的是內容,所思所想,而不是花樣格式.

Markdown的創始人是John Gruber,Markdown作為一種輕量級的「標記語言」,它使我們專心于碼字,用「標記」語法,來代替常見的排版格式.

?段落
一段內容當做一個段落來顯示,則需要保證該段內容上方及下方至少各有一個空行(空行含義:某一行只包含空白便會被視為空行)

如何對段落進行換行?
不得不說段落這里是比較繞的哈，了解就行

1. 使用兩個以上空格鍵加上回車{敲個回車鍵}選擇題提示:MarkDown中使用回車就可以進行段落的換行為錯誤說法
2. 在段落后面使用一個空行來表示重新開始一個段落{敲2個回車,第二個回車寫內容代表另起一段}
3. 在第一行的末尾添加br標簽進行換行,就會顯示成兩段內容{添加br敲回車另起一段}

強調說明:
Markdown使用星號*和下劃線_作為標記強調字詞的符號.

斜體

• 在Markdown中,將內容用*或_包裹起來,包圍的字詞會被轉成用標簽包圍,會顯示成斜體
• 如果要在文字前后直接插入普通的星號可以用反斜杠\ *
• 如果要在文字前后直接插入普通的_插入下劃線\ _
• 注意符號連接在一起

粗體

用兩個*或_包起來就會轉換成粗體

洗掉線

使用兩個 ~ 來給內容加上洗掉線,舉例:這個內容是被刪掉的

下劃線

輸入3個星號*或者hr標簽

?標題{Markdown支持兩種標題的語法Setext和atx形式}

Setext形式是用底線的形式,利用= (一級標題)和- (二級標題),效果等同h1-h2

舉例:注意事項{Setext形式的標題至少需要3個以上的=或_才可以正常顯示為標題樣式}

標題1
=====
標題2
-------

Atx形式標題,則是在行首插入1到6個#(最多支持6級標題)對應到h1-h6
舉例:

# 標題1
## 標題2

?鏈接
Markdown支持兩種形式的鏈接語法:行內和參考形式鏈接.不管是哪一種,鏈接的文字都是用[方括號]來標記.

行內形式的鏈接

在方塊括號后面接括號并插入網址鏈接即可,如果你還想要加上鏈接的alt提示文字,只要在網址后面,用雙引號把alt文字包起來即可.

其格式為內容

例如個人博客

參考形式鏈接使用另外一個方括號接在鏈接文字的括號后面,而在第二個方括號里面要填入用以辨識鏈接的標簽
可以使用[內容]:http_url@提示的形式添加一個超鏈接

注釋:個人學習參考形式鏈接不推薦

?學過Markdown參考形式圖片更正下

可以使用參考樣式的方式添加一個鏈接,其結構為 [內容][1] + [1]: http_url "alt 提示" 的組合

舉例:

[鬼牛阿飛][wiki]

[wiki]: http://www.dhnblog.cn/ "鬼牛阿飛個人博客"

代碼:

[鬼牛阿飛][]

[鬼牛阿飛]: http://www.dhnblog.cn/

鏈接的定義可以放在檔案中的任何一個地方,建議直接放在鏈接出現段落的后面,也可以把它放在檔案最后面.

?圖片

行內形式圖片的語法格式為

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

注釋:剛把百度里面的圖片復制修改下,在部分內容編輯器可能提示為:[外鏈圖片轉存失敗,源站可能有防盜鏈機制,建議將圖片保存下來直接上傳(img-S0buDZ6F-1670403330252)(/path/to/img.jpg "Optional title")]

參考形式圖片的語法格式

![Alt text][id]

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

舉例:

?串列:Markdown支持有序串列、無序串列和任務串列 三種形式的串列

無序串列使用 * 、 + 或是 - 作為串列標記{符號空格/文字}

有序串列則使用小寫數字接著一個英文句號{數字.空格/文字}

當在行首出現數字-句點-空白的內容時，Markdown 會將其當做一個串列進行展示，要避免這樣的狀況,可以在句點前面加上轉義符 \
1987. What a great season.
串列也可以進行嵌套或者與其他 Markdown 內容

任務串列的語法格式為 - [ ] text，其中 [ ] (帶空格的中括號)表示未完成的任務，x 表示已經完成的任務

代碼:

- [x] 起床
- [x] 吃飯
- [ ] 作業
- [ ] 睡覺

效果:

• 起床
• 吃飯
• 作業
• 睡覺

?分隔線

可以在一行中用三個或以上的、-、_來創建一個分隔線,行內不能有其他東西.你也可以在星號中間插入空白

參考

Markdown 使用 email 形式的區塊參考,我們在要參考內容每行的最前面加上 > ,就可以在 Markdown 檔案中創建一個區塊參考:

1. 允許只在整個段落的第一行最前面加上 >
2. 區塊參考可以有級別（例如:參考內的參考）,只要根據級別加上不同數量的 >

代碼:

> Perl語言的發明人Larry Wall說,好的程式員有3種美德: 懶惰、急躁和傲慢(Laziness, Impatience and hubris).
>
> > 程式員有三種美德:懶惰,急躁和傲慢. —— **Larry Wall**
>
> 懶惰,會使得你花大力氣去避免消耗過多的精力.它敦促你寫出節省體力的程式,同時別人也能利用它們.為此你會寫出完善的檔案,以免別人問你太多問題.
急躁,當你發現計算機懶洋洋地不給出結果.于是你寫出更優秀的代碼,能盡快真正的解決問題.至少看上去是這樣.
傲慢,極度的自信,使你有信心寫出(或維護)別人挑不出毛病的程式.
>

效果:

Perl語言的發明人Larry Wall說,好的程式員有3種美德: 懶惰、急躁和傲慢(Laziness, Impatience and hubris).

程式員有三種美德:懶惰,急躁和傲慢. —— Larry Wall

懶惰,會使得你花大力氣去避免消耗過多的精力.它敦促你寫出節省體力的程式,同時別人也能利用它們.為此你會寫出完善的檔案,以免別人問你太多問題.
急躁,當你發現計算機懶洋洋地不給出結果.于是你寫出更優秀的代碼,能盡快真正的解決問題.至少看上去是這樣.
傲慢,極度的自信,使你有信心寫出(或維護)別人挑不出毛病的程式.

3.參考的區塊內也可以使用其他的 Markdown 語法,包括標題、串列、代碼塊等{支持嵌套}

代碼塊

行內代碼的格式很簡單,只需要使用兩個 ` 將代碼內容包裹起來即可

縮進顯示代碼{一個代碼塊會一直持續到沒有縮排的那一行(或是檔案結尾)}
縮排 4 個空白{空格}或是 1 個 tab 就可以

在代碼塊里面, & 、 < 和 > 會自動轉成 HTML 特殊字符,這樣的方式讓你非常容易使用 Markdown 插入 HTML 的原始示例代碼
就是說在Markdown代碼塊里面,不用打特殊字符,比方>,原本是>現在直接輸入>就可以了.

高亮顯示代碼段

除了縮進顯示代碼段之外,Markdown 還支持高亮顯示的代碼段,創建高亮顯示的代碼段時,將代碼段由帶有三個反引號（ ``` ）的行圍起來,并在第一個圍欄的末尾標識上語言型別即可

	```javascript
	// A highlighted block
	var foo = 'bar';
	```

```javascript
// A highlighted block
var foo = 'bar';
```

當然也可以不指定語言型別{如果```的這個并排顯示,效果等于行內代碼塊``,不過測驗題目中提示該語法不正確}

	```
	echo "Hello"
	```

```
echo "Hello"
```

Diff 語法{需要注意的是,如果差異內容中包 ,請確保使用反斜杠\ 來轉義每個反引號 ,否則差異突出顯示將無法正確呈現.}

	```diff
	var foo = 'bar';
	+ var x = 200;
	* var x = 100;
	```

```diff
var foo = 'bar';
+ var x = 200;
* var x = 100;
```

更正下如何轉義?示例:

\`

否則展示就是這樣式的:Diff 語法{需要注意的是,如果差異內容中包 ,請確保使用反斜杠\ 來轉義每個反引號 ,否則差異突出顯示將無法正確呈現.}

原本內容其實是:Diff 語法{需要注意的是,如果差異內容中包 `,請確保使用反斜杠\ 來轉義每個反引號` ,否則差異突出顯示將無法正確呈現.}

?表格

單元格展示為

|  |  |
|--|--|
|  |  |

舉例為

代碼為

| header1 | header2 |header3|
|---|---|---|
|cell 4 | cell 5 is longer |  sadasdas |
|dsasad  | asdsada | cell 6 is much longer than the others, <br>but that’s ok. It will eventually wrap<br> the text when the cell is too<br> large for the display size. |
|cell7||cell9|

語法要求

1. 第一行包含表頭，并用"豎線"（ | ）分隔
2. 第二行將標題與單元格分開，并且必須包含三個或更多破折號
3. 第三行以及隨后的任何行均包含單元格值

注意事項

不能在 Markdown 中將單元格分隔成多行，它們必須保持為單行，如果需要，還可以使用 HTML <br>標記對內容進行強制換行
第二行單元長短與標題不需要保持一致，但必須用豎線（|）分隔
可以有空白的單元格

如何設定單元格內文本對齊方式?可以通過添加冒號:的形式{指定每一列的文本對齊方式需要在在第二行添加}

學習Markdown 這里的編輯預覽沒法展示,換個內容編輯器查看操作下

• :--: 兩端都有冒號表示內容和標題欄居中對齊
• :--- 左側冒號表示內容和標題欄居左對齊
• ---: 右側冒號表示內容和標題欄居右對齊

標籤：其他

上一篇：內網安全 - 簡單域環境搭建

下一篇：Zabbix6.0使用教程 (一)—zabbix新增功能介紹1