如何使用 Markdown 書寫博客

• Markdown 是什麼？

Markdown是一種輕量級標記語言，你能夠簡單地理解爲HTML的簡化版，Markdown簡單的語法使閱讀和創做文檔變得容易。由於語法特別簡單並且容易排版，Markdown常常被用來書寫我的博客。

Markdown簡單易學，語法點不多，基本上一個小時就能夠學完。下面將會具體介紹Markdown的基本語法，學會這些，你也能夠本身寫一篇排版優美的博客了！

---

• 基礎語法

與HTML同樣，Markdown也有本身的文件格式，已md結尾，如：test.md

---

• 標題

Markdown標題語法很是簡單，只要在文本前面加#號便可，以下：

# 標題1
## 標題2
### 標題3
#### 標題4
##### 標題5
複製代碼

效果以下：

標題1

標題2

標題3

標題4

標題5

• 引述

---

在Markdown中使用引述，只需在引用文本前加「>」就好了：

> 這是一個引述
>> 嵌套引述
複製代碼

效果：

這是一個引述

嵌套引述

• 字體格式

---

Markdown中，使用_文本_的格式來斜體文本，使用__文本__的格式來加粗文本，具體以下(注: _均可以使用*來代替 , 就看你的我的喜愛了):

_斜體_

**加粗**

___斜體加粗___

複製代碼

斜體

加粗

斜體加粗

• 列表

列表語法中,如下符合是等效的: * , - , +

看我的喜愛咯.

代碼:

- 一
- 二
- 三
 -- 二級列表
複製代碼

效果:

• 一
• 二
• 三
  • 二級列表

有序列表:

1. 一
2. 二
3. 三
4. 四
 - 能夠搭配無序列表
 - 4.1
 - 4.2
複製代碼

效果:

1. 一
2. 二
3. 三
4. 四
   • 能夠搭配無序列表
   • 4.1
   • 4.2

• 連接

Markdown連接有三種格式:

1. 行內式： 格式爲 [link text](URL 'title text')。

代碼：

[百度一下,你就知道](http://www.baidu.com/)
複製代碼

效果：

百度一下,你就知道

2. 參考式（推薦）：

參考式連接的寫法至關於行內式拆分紅兩部分，並經過一個識別符來鏈接兩部分。參考式能儘可能保持文章結構的簡單，也方便統一管理URL。

我的推薦使用參考式，這樣咱們能夠把URL放在文件開頭處，便於修改和管理，參考式相對於行內式有一個明顯的優勢，就是能夠在多個不一樣的位置引用同一個URL。示例代碼以下：

首先，定義連接(兩個都是方括號)： 第二個方括號內爲連接獨有的識別符，能夠是字母，數字，空白，注意其不區分大小寫。

[百度][link]
空白形式：
[百度][]
複製代碼

效果：

百度

空白形式：

百度

定義連接內容： 其格式爲：[識別符]: URL 「title」。 示例代碼以下：

[link]: http://www.baidu.com/ "百度"
空白形式：
[百度]: http://www.baidu.com/ "百度"
複製代碼

title 可寫可不寫， 我通常是先把連接定義在文件開頭，而後再在文章內引用。

3. 直接式

這種形式適合來書寫郵箱和引用連接，格式爲<URL> 代碼：

<www.baidu.com>

<www.example@email.com>
複製代碼

效果：

<www.baidu.com>

www.example@email.com

---

• 圖片

Markdown中引用圖片格式以下：

插入圖片的語法和插入超連接的語法基本一致，只是在最前面多一個!。也分爲行內式和參考式兩種。

格式爲 。同樣的，title text內容可寫可不寫。示例代碼：

1. 行內式：

![GitHub](https://user-gold-cdn.xitu.io/2019/2/16/168f4f17755344a8?w=100&h=100&f=jpeg&s=2170 "GitHub,Social Coding")
複製代碼

效果：

GitHub,Social Coding

2. 參考式（推薦）：

![GitHub][github]

[github]: https://user-gold-cdn.xitu.io/2019/2/16/168f4f17755344a8?w=100&h=100&f=jpeg&s=2170 "GitHub,Social Coding"
複製代碼

效果：

---

• 代碼塊

Markdown中代碼塊格式以下： 示例：

```python
import os
print("Hello")
```

三個```要獨佔一行, ```後寫上所寫的語言名，就可使用相應語言的語法高亮。 效果：

import os
print("Hello")
複製代碼

• 表格

Markdown中搭建表格很是簡單，語法以下：

使用 | 來分隔不一樣的單元格，使用 - 來分隔表頭和其餘行

示例代碼：

name | age
---- | ---
LearnShare | 12
Mike |  32
複製代碼

更加美觀的寫法：

|    name    | age |
| ---------- | --- |
| LearnShare |  12 |
| Mike       |  32 |
複製代碼

效果：

name	age
LearnShare	12
Mike	32

對齊： 在表頭下方的分隔線標記中加入 :，便可標記下方單元格內容的對齊方式：
:--- 表明左對齊
:--: 表明居中對齊
---: 表明右對齊

代碼：

| left | center | right |
| :--- | :----: | ----: |
| aaaa | bbbbbb | ccccc |
| a    | b      | c     |
複製代碼

效果：

left	center	right
aaaa	bbbbbb	ccccc
a	b	c

---

• 目錄索引

對一篇長的文章來講，一個帶位置定位的目錄是很重要的，幸運的是，在Markdown中實現並不難，具體語法與連接類似：
[標題](#要引用的標題內容) 注：標題內容不區分大小寫 示例：

## section
- [test](#test)
複製代碼

如上，就能夠定位到test標題的位置了。
效果：（簡書或者其餘一些博客網站貌似不支持頁面內目錄跳轉，這裏就不演示了）

section

• test

---

• 擴展

1.分隔線

Markdown中,能夠在一行中使用三個或更多的 *、- 或 _ 來添加分隔線 要注意與文本之間要有空行:

---
複製代碼

效果:

---

2.刪除線

Markdown使用~~來做爲刪除線，使用方法以下： 代碼：

這是 ~~要刪除的文本~~
複製代碼

效果：
這是 要刪除的文本

3.字符轉義

反斜線（\）用於插入在 Markdown 語法中有特殊做用的字符。 例如：

這是用來 *演示* 的 _文本_
這是用來 \*演示\* 的 \_文本\_
複製代碼

效果：
這是用來 演示 的 文本
這是用來 *演示* 的 _文本_

---

寫在最後

以上，就是Markdown的基本語法了，這些東西熟練掌握後，寫幾篇我的博客就徹底是手到擒來了。

雖然簡單，仍是要寫幾篇博客來練習加深記憶，寫博客的過程就是學習的過程，無論你寫的是什麼，哈哈，這是一位大佬跟我說的。這也是個人第一篇博客，接下來我也但願本身能堅持並養成寫博客的這個習慣。

若是看完了，就趕忙去寫你本身的一篇博客吧！

參考

• Learning-Markdown
• Introduction To Markdown Using Visual Studio Code