Markdown的使用筆記

Markdown的使用筆記

Markdown在我看是一種使用幾種標記符號就能夠完成清晰排版的一種標記語言，是寫筆記文章的一大利器，使用簡單、方便，上手快，並且能夠很好的兼容html，即html中的標籤在markdown中也一樣試用。這邊文章主要是介紹了使用Markdown時的一些經常使用標記，便於新手學習、使用。也爲本身之後忘記了作一個提醒。想要看完整版的Markdown語法能夠查看markdown中文版語法。

目錄

• 1.標題
  
• 2.連接
• 3.圖片
• 4.表格
• 5.列表
• 6.換行
• 7.代碼
• 8.連接
• 9.引用
• 10.附加內容
• 10.2.頁面跳轉
• 10.2.markdown中特殊符號

1.標題

1.1使用'#'進行標題分級

在Markdown中使用#做爲標籤的級數,符號‘#’的個數表示標題的級數，總共有六級。

試用示例

#1
##2
###3
####4
#####5
######6

示例結果

1

2

3

4

5

6

1.2使用'='和'-'進行標題分級

在Markdown中使用'='和'-'做爲標記標題的符號。
'='：表示一級標題
'-'：表示二級標題

試用示例

標題一
======
標題二
------

示例結果

標題一

標題二

2.連接

連接的使用格式以下：

[連接標題](連接地址)

試用示例

[百度](www.baidu.com)

試用結果

百度

注意事項

此處的'()'必須是英文的'()'.

3.圖片

Markdown 使用一種和連接很類似的語法來標記圖片，有兩種形式：行內式和參考式。

3.1行內式

行內式的使用格式以下：

格式1：！[圖片替代文字](圖片地址)
格式2：！[圖片替代文字](圖片地址 "圖片標題")

注：圖片替代文字至關於html中標籤的alt屬性，圖片地址至關於src屬性，"圖片標題"至關於title屬性。

試用示例

![111](https://ss0.baidu.com/6ONWsjip0QIZ8tyhnq/it/u=1593486624,3032607273&fm=58&bpow=540&bpoh=540)

![111](https://ss0.baidu.com/6ONWsjip0QIZ8tyhnq/it/u=1593486624,3032607273&fm=58&bpow=540&bpoh=540 "圖片1")

試用結果

3.2參考式

參考式的使用格式以下：

![Alt text][id]
id格式1：[id]:圖片地址
id格式2：[id]:圖片地址 "圖片標題"

試用示例

![111][#picex1]
[#picex1]:https://ss0.baidu.com/6ONWsjip0QIZ8tyhnq/it/u=1593486624,3032607273&fm=58&bpow=540&bpoh=540
![222][#picex2]
[#picex2]:https://ss0.baidu.com/6ONWsjip0QIZ8tyhnq/it/u=1593486624,3032607273&fm=58&bpow=540&bpoh=540 "圖片2"

試用結果

[111][#picex1]
[#picex1]:https://ss0.baidu.com/6ONWsjip0QIZ8tyhnq/it/u=1593486624,3032607273&fm=58&bpow=540&bpoh=540
[222][#picex2]
[#picex2]:https://ss0.baidu.com/6ONWsjip0QIZ8tyhnq/it/u=1593486624,3032607273&fm=58&bpow=540&bpoh=540 "圖片2"

4.表格

markdown中使用 | 分割不一樣的單元格，使用-來分割表頭和其餘行，爲了美觀，可使用空格對齊不一樣行的單元格，並在左右兩側都使用|來標記單元格邊界。
在表頭下方的分割線標記中加入 : ,便可標記下方單元格內容的對齊方式，: 的位置表示不一樣的對齊方式，具體以下：

:---表明左對齊（:在最左邊）    
 :---:表明居中對齊（：在兩端）  
 ---:表明右對齊（:在最右端）

注：此處的:爲英文的:。

試用示例

書寫形式一：

|序號 |姓名 |班級 |

|:----|:---|:---|

|001 |張三|一班 |

書寫形式二：

序號 |姓名 |班級

:----|:---|:---

001 |張三|一班

試用結果

序號	姓名	班級
001	張三	一班

序號	姓名	班級
001	張三	一班

注：

1. 在MarkdownPad2中可能沒法直接支持表格，須要在Markdown中按照以下方式進行設置：
   工具（Tools） 》選項（Options） 》 Markdown 》Markdown處理器(Markdown Proccessor) 改成 「Markdown(擴展(Extra))」便可。
   具體可見：MarkdownPad2 表格並不顯示的問題。
   
2. 此時要想實現該小節的試用示例形式，直接使用Markdown中的空4格或者一個製表符（tab）是不行的，須要在這段文字先後加上<code><pre>和</code></pre>

5.列表

Markdown中有兩種列表的形式：無序列表和有序列表

5.1無序列表

Markdown中無序列表使用星號（*）、加號（+）或是減號（-）做爲列表標記，列表標記與列表內容之間間隔一個空格。

試用示例

形式一： 
 
* 列表1
* 列表2
* 列表3

形式二:  

- 列表4
- 列表5
- 列表6

形式三：  

+ 列表7
+ 列表8
+ 列表9

試用結果

形式一：

• 列表1
• 列表2
• 列表3

形式二:

• 列表4
• 列表5
• 列表6

形式三：

• 列表7
• 列表8
• 列表9

5.2有序列表

Markdown中有序列表標記使用數字接着一個英文句點（.），一樣列表標記和列表內容之間應該間隔一個空格。

試用示例1

1. 列表1
2. 列表2
3. 列表3

試用結果1

1. 列表1
2. 列表2
3. 列表3

注意：列表標記上使用的數字並不會影響輸出列表的序號，可是建議第一個項目最好仍是從 1. 開始，由於 Markdown 將來可能會支持有序列表的 start 屬性。

試用示例2

1. 列表1
4. 列表2
6. 列表3

試用結果3

1. 列表1
2. 列表2
3. 列表3

6.換行

在寫文章的過程當中換行是很常見的一種狀況，可是在markdown中正文與正文直接直接換行，是沒法起到換行的做用的，常見的換行方法有三種。

6.1在行末加兩個空格

在行末加入兩個空格至關於在行末插入標籤<br>

試用示例

試用結果

6.2在段前空一行

試用示例

這是第一段

這是第二段

這是第三段

試用結果

這是第一段

這是第二段

這是第三段

注：在段落末尾加兩個空格至關於在文末插入<br>，空行至關於將文字包括早標籤<p>和</p>中。

7.代碼

markdown中對代碼的標記能夠分爲對行內代碼的標記和區塊代碼的標記。

7.1行內代碼

對於行內代碼可使用一對反引號（`）將行內代碼包起來，使用行內代碼的使用。（反引號能夠在英文模式下，直接按鍵盤的左上角數字1旁邊的一個鍵實現）

試用示例

這是行內代碼`printf("hello world!")`。

試用結果

這是行內代碼printf("hello world!")

若代碼中包括反引號（`）,可使用多個反引號開啓和結束代碼區段。

試用示例

這是行內代碼``printf(hello world!`)``。

試用結果

這是行內代碼printf(`hello world!`)。

若想在代碼區塊的一開始就插入一個反引號，能夠在開始和結束前插入空格實現該效果。

試用示例

這是行內代碼`` `printf(hello world!`) ``。
這是行內代碼`` `printf(hello world!`)``。
這是行內代碼`` `printf(hello world!`)```。
這是行內代碼`` `printf(hello world!`)` ``。

試用結果

這是行內代碼`printf(hello world!`)。

這是行內代碼`printf(hello world!`)。

這是行內代碼`` printf(hello world!)```。

這是行內代碼`printf(hello world!`)`。

7.2代碼區塊

Markdown 中要實現代碼區塊很簡單，只要簡單地縮進 4 個空格或是 1 個製表符就能夠。

試用示例

這是一個普通段落：

    這是一個代碼區塊。

試用結果

這是一個普通段落：

這是一個代碼區塊。

8.連接

（1）文字加粗：markdown中在要加粗的文字首尾分別加上兩個**實現文字的加粗。
（2）文字斜體：markdown中在要加粗的文字首尾分別加上一個*實現文字的加粗。
（3）字體設置：使用標籤設置文本文字的字體、大小和顏色。

試用示例

**我是加粗字體**  
*我是斜體*  
<font face="黑體">我是黑體字</font>  
<font face="微軟雅黑">我是微軟雅黑</font>  
<font face="STCAIYUN">我是華文彩雲</font>  
<font color=red>我是紅色</font>  
<font color=#008000>我是綠色</font>  
<font color=Blue>我是藍色</font>  
<font size=5>我是尺寸</font>  
<font face="黑體" color=green size=5>我是黑體，綠色，尺寸爲5</font>

試用結果

我是加粗字體
我是斜體
我是黑體字
我是微軟雅黑
我是華文彩雲
我是紅色
我是綠色
我是藍色
我是尺寸
我是黑體，綠色，尺寸爲5

9.連接

Markdown使用引用可能只須要在引用的內容前加上>就能夠。

試用示例

>這是引用的內容

試用結果

這是引用的內容

10.附加內容

10.1頁面跳轉

不少時候咱們在寫文章特別是內容較長的文章的時候但願，前面會有一個導航目錄，點擊相應的目錄時可以跳轉到相應的位置。我在寫這篇文章的時候就想用到這個功能，因而就在網上查了一些資料。

1.Markdown實現

試用示例

步驟1:生產目錄

* [1.語法示例](#title1)
* [1.1圖片](#title1.1)
* [1.2換行](#title1.2)

步驟2:在正文中，將章節標題的id對應上去

<h2 id="1">1.語法示例</h2>
這是id爲1跳轉位置
<h3 id="1.1">1.1圖片</h3>
這是id爲1.1跳轉位置

試用結果

• 1.語法示例
• 1.1圖片
• 1.2換行

1.語法示例

這是id爲1跳轉位置

1.1圖片

這是id爲1.1跳轉位置

1.2換行

這是id爲1.2跳轉位置
注：某些編輯器可能並不適用，好比簡書，可是在博客園是適用的。

2.html標籤的實現

1.定義一個錨(id)：<span id="jump">跳轉到的地方</span>
2.使用markdown語法：[點擊跳轉](#jump)

10.2Markdown中的特殊符號

因爲前面已經說過Markdown能夠和html語言很好的兼容，因此html中特殊符號的使用在Markdown中也一樣適用。

參考資料

[1]Markdown中如何添加特殊符號.https://blog.csdn.net/Logicr/article/details/82414854.
[2]Markdown介紹及使用教程.https://www.jianshu.com/p/7771794c88a1.
[3]Markdown進階（更改字體、顏色、大小，設置文字背景色，調整圖片大小設置居中）
[4]Markdown中文版語法說明.https://www.appinn.com/markdown/

持續更新中……