Markdown 基本語法

程式設計師的貓發表於2019-07-26

Markdown是一種純文字格式的標記語言。通過簡單的標記語法，它可以使普通文字內容具有一定的格式。

相比WYSIWYG編輯器

優點：\
1、因為是純文字，所以只要支援Markdown的地方都能獲得一樣的編輯效果，可以讓作者擺脫排版的困擾，專心寫作。\
2、操作簡單。比如:WYSIWYG編輯時標記個標題，先選中內容，再點選導航欄的標題按鈕，選擇幾級標題。要三個步驟。而Markdown只需要在標題內容前加#即可

缺點：\
1、需要記一些語法（當然，是很簡單。五分鐘學會）。\
2、有些平臺不支援Markdown編輯模式。

還好，簡書是支援Markdown編輯模式的。

開啟方式：設定->預設編輯器->Markdown編輯器

在想要設定為標題的文字前面加#來表示\
一個#是一級標題，二個#是二級標題，以此類推。支援六級標題。

注：標準語法一般在#後跟個空格再寫文字，貌似簡書不加空格也行。

示例：

# 這是一級標題
## 這是二級標題
### 這是三級標題
#### 這是四級標題
##### 這是五級標題
###### 這是六級標題

效果如下：

這是二級標題

這是三級標題

這是四級標題

這是五級標題
這是六級標題
  • 加粗

要加粗的文字左右分別用兩個*號包起來

  • 斜體

要傾斜的文字左右分別用一個*號包起來

  • 斜體加粗

要傾斜和加粗的文字左右分別用三個*號包起來

  • 刪除線

要加刪除線的文字左右分別用兩個~~號包起來

示例：

**這是加粗的文字**
*這是傾斜的文字*`
***這是斜體加粗的文字***
~~這是加刪除線的文字~~

效果如下：

這是加粗的文字\
這是傾斜的文字\
這是斜體加粗的文字\
這是加刪除線的文字

在引用的文字前加>即可。引用也可以巢狀，如加兩個>>三個>>>\
n個...\
貌似可以一直加下去，但沒神馬卵用

示例：

>這是引用的內容
>>這是引用的內容
>>>>>>>>>>這是引用的內容

效果如下：

這是引用的內容

這是引用的內容

這是引用的內容

三個或者三個以上的 - 或者 * 都可以。

示例：

---
----
***
*****

效果如下：\
可以看到，顯示效果是一樣的。

語法：

![圖片alt](圖片地址 ''圖片title'')

圖片alt就是顯示在圖片下面的文字，相當於對圖片內容的解釋。
圖片title是圖片的標題，當滑鼠移到圖片上時顯示的內容。title可加可不加

示例：

![blockchain](https://ss0.bdstatic.com/70cFvHSh_Q1YnxGkpoWK1HF6hhy/it/
u=702257389,1274025419&fm=27&gp=0.jpg "區塊鏈")

效果如下：

上傳本地圖片直接點選導航欄的圖片標誌，選擇圖片即可

語法：

[超連結名](超連結地址 "超連結title")
title可加可不加

示例：

[簡書](http://jianshu.com)
[百度](http://baidu.com)

效果如下：

簡書\
百度

注：Markdown本身語法不支援連結在新頁面中開啟，貌似簡書做了處理，是可以的。別的平臺可能就不行了，如果想要在新頁面中開啟的話可以用html語言的a標籤代替。

<a href="超連結地址" target="_blank">超連結名</a>

示例
<a href="https://www.jianshu.com/u/1f5ac0cf6a8b" target="_blank">簡書</a>
  • 無序列表

語法：\
無序列表用 - + * 任何一種都可以

- 列表內容
+ 列表內容
* 列表內容

注意：- + * 跟內容之間都要有一個空格

效果如下：

  • 列表內容

  • 列表內容

  • 列表內容

  • 有序列表

語法：\
數字加點

1.列表內容
2.列表內容
3.列表內容

注意：序號跟內容之間要有空格

效果如下：

1.列表內容\
2.列表內容\
3.列表內容

  • 列表巢狀

上一級和下一級之間敲三個空格即可

  • 一級無序列表內容

    • 二級無序列表內容
    • 二級無序列表內容
    • 二級無序列表內容

  • 一級無序列表內容

    1. 二級有序列表內容
    2. 二級有序列表內容
    3. 二級有序列表內容

  1. 一級有序列表內容

    • 二級無序列表內容
    • 二級無序列表內容
    • 二級無序列表內容

  2. 一級有序列表內容

    1. 二級有序列表內容
    2. 二級有序列表內容
    3. 二級有序列表內容

語法：

表頭|表頭|表頭
---|:--:|---:
內容|內容|內容
內容|內容|內容

第二行分割表頭和內容。
- 有一個就行，為了對齊，多加了幾個
文字預設居左
-兩邊加：表示文字居中
-右邊加：表示文字居右
注：原生的語法兩邊都要用 | 包起來。此處省略

示例：

姓名|技能|排行
--|:--:|--:
劉備|哭|大哥
關羽|打|二哥
張飛|罵|三弟

效果如下：

姓名 技能 排行
劉備 哭 大哥
關羽 打 二哥
張飛 罵 三弟

語法：\
單行程式碼：程式碼之間分別用一個反引號包起來

    `程式碼內容`

程式碼塊：程式碼之間分別用三個反引號包起來，且兩邊的反引號單獨佔一行

(```)
  程式碼...
  程式碼...
  程式碼...
(```)

注：為了防止轉譯，前後三個反引號處加了小括號，實際是沒有的。這裡只是用來演示，實際中去掉兩邊小括號即可。

示例：

單行程式碼

`create database hero;`

程式碼塊

(```)
    function fun(){
         echo "這是一句非常牛逼的程式碼";
    }
    fun();
(```)

效果如下：

單行程式碼

create database hero;

程式碼塊

function fun(){
  echo "這是一句非常牛逼的程式碼";
}
fun();

```flow
st=>start: 開始
op=>operation: My Operation
cond=>condition: Yes or No?
e=>end
st->op->cond
cond(yes)->e
cond(no)->op
&```

效果如下：\
所以截了個圖

相關文章