MarkDown 基本語法

一、MarkDown是什么好東西?

1.認識MarkDown

MarkDown 是一個 Web 上使用的文本到HTML的轉換工具签夭,可以通過簡單、易讀易寫的文本格式生成結構化的HTML文檔椎侠,MarkDown中文教程(教程-MarkDown)上的介紹第租,讀完有點懵。簡單理解我纪,MarkDown格式很簡單慎宾,然后以MarkDown格式書寫的文章可以直接以純文本發(fā)布到支持Markdown編輯模式的平臺上,省去排版的困擾浅悉。

2.MarkDown優(yōu)點

  • 簡單直觀易學
  • 純文本內容趟据,專心考慮內容,無需困擾排版
  • 可以運用在幾乎任何有文字的地方

二术健、有哪些MarkDown的基本語法汹碱?

1.標題

MarkDown通過在行首添加1-6個 # 符號+空格來定義1-6級標題(有的網站不加空格也能識別,但是最好加)荞估。

  • 書寫格式
    # 一級標題
    ## 二級標題
    ### 三級標題
    #### 四級標題
    ##### 五級標題
    ###### 六級標題
    眼花繚亂的#咳促,數數數到眼睛疼

  • 解析效果

一級標題

二級標題

三級標題

四級標題

五級標題
六級標題

在簡書上寫這篇博客的時候發(fā)現(xiàn)一個很有趣的東西,哈哈勘伺,上圖
本來想加無序列表的跪腹,結果剛打- 上去就把前面的文字變成標題了

在- 后加了文字就正常了

查了一下,是因為可以使用=(高階標題) 和- (次階標題)來標記一級和二級標題娇昙,任何數量的= 和- 都有效果尺迂。

  • 書寫格式

一級標題
=
二級標題
-

  • 解析效果

一級標題

二級標題


2. 段落

直接寫內容就顯示為段落,就是這么簡單粗暴。

  • 書寫格式
    這是一個段落
  • 解析效果
    這是一個段落

看起來沒有毛線區(qū)別

3.插入圖片

語法:! [ 圖片下方顯示的東西噪裕,可以隨便寫什么也可以不寫 ] ( 圖片的線上地址蹲盘,可以加標題也可以不加 )。本地圖片可以使用圖床膳音,具體方法可自行查閱召衔。![]()

  • 書寫格式


  • 解析效果


注:和HTML相同,插入的圖片也可以有一個鼠標懸浮在圖片上放就顯示設置的標題的效果祭陷,簡單的在圖片地址后面加"Title"苍凛,Title就是鼠標懸浮顯示的標題。

4.插入鏈接

語法:[ 鏈接顯示文字 ]( 鏈接地址 "Title" )兵志,Title即鼠標懸浮到此處顯示的標題醇蝴,可加可不加。

5.文字效果

加粗

兩種方式:兩個(*)或者底線(_)作為標記強調字詞的符號想罕,將需要加粗的文字包圍即可悠栓。

斜體

兩種方式:一個(*)或者底線(_)作為標記強調字詞的符號,將需要傾斜的文字包圍即可按价。

加粗+斜體

兩種方式:三個(*)或者底線(_)作為標記強調字詞的符號惭适,將需要加粗+傾斜的文字包圍即可。

刪除線

兩個波浪線~~作為標記強調字詞的符號楼镐,將需要加刪除線的文字包圍即可癞志。

  • 書寫格式
    這是一段普通的文字
    **這是一段要加粗的文字**
    __這是另外一段要加粗的文字__
    *這是一段要傾斜的文字*
    _這是另外一段要傾斜的文字_
    ***這是一段要加粗和傾斜的文字***
    ___這是另外一段要加粗和傾斜的文字___
    ~~這是一段要加刪除線的文字~~
    * 這是一段要傾斜但是 ** 前后都有空白沒有傾斜的文字 *

  • 解析效果

這是一段普通的文字
這是一段要加粗的文字
這是另外一段要加粗的文字
這是一段要傾斜的文字
這是另外一段要傾斜的文字
這是一段要加粗和傾斜的文字
這是另外一段要加粗和傾斜的文字
這是一段要加刪除線的文字

注:如果*或_或~兩邊都有空格的話,他們會被當作普通符號框产。

6.列表

無序列表

- + *加空格凄杯,后跟內容。

有序列表

數字加.秉宿,序號與內容間要有空格盾舌。

  • 書寫格式
    - 我是一個無序列表
    + 我也是
    * 好巧,我也是
    1.我是第一個有序列表
    2.我是第二個有序列表
    3.我是第三個有序列表

  • 解析效果

  • 我是一個無序列表

  • 我也是
  • 好巧蘸鲸,我也是
    1.我是第一個有序列表
    2.我是第二個有序列表
    3.我是第三個有序列表

列表嵌套

上級和下級間敲三個空格即可妖谴。

  • 書寫格式
    - 我是一個無序列表
    + 好巧,我也是
    * 神奇酌摇,我也是哦
    1.我是第一個有序列表
    - 我是二級無序列表
    2.我是第二個有序列表
    3.我是第三個有序列表
  • 解析效果
  • 我是一個無序列表
  • 好巧膝舅,我也是
  • 神奇,我也是哦
    1.我是第一個有序列表
  • 我是二級無序列表
    2.我是第二個有序列表
    3.我是第三個有序列表
注:這里只演示了有序列表嵌套一個無序列表的寫法窑多,其他的嵌套組合也是有效的仍稀,可自行測試。

7.表格

  • 書寫格式(表頭與前面內容隔一行)
    |表頭|表頭|表頭|
    |:-|:--:|---:|
    |內容|內容|內容|
  • 解析效果
表頭 表頭 表頭
內容 內容 內容
注:第二行元素分隔表頭和內容埂息,其中 - 一個以上即可技潘, : 在左即內容左對齊遥巴,在右即內容右對齊,兩邊都有即居中對齊享幽。

8.引用

  • 書寫格式
    >這是第一個引用
    >>這個第二個引用
    >>>這是第三個引用
  • 解析效果

這是第一個引用

這個第二個引用

這是第三個引用

9. 代碼

單行代碼

語法:代碼左右分別一個 `(反引號铲掐,鍵盤上波浪線下面的符號)包裹代碼即可。

  • 書寫方式

`var a = 1`

  • 解析效果

var a = 1

代碼塊

語法:代碼左右兩邊分別用三個```包裹代碼塊即可值桩。

  • 書寫格式

```
var a = 1
var b = 2
```

  • 解析效果摆霉。
    var a = 1
    var b = 2

代碼高亮

在寫需要展示的代碼時,標明代碼的種類奔坟,有的瀏覽器會自動的給代碼加一些顏色

  • 書寫格式
    ```JavaScript
    var a = 1
    var b = 2
    ```

  • 解析效果

    var a = 1
    var b = 2

10.分割線

語法:三個或以上 * 或 - 或 _ 可有分割線效果 携栋。

  • 書寫方式
    ***
    ---
    ___
  • 解析效果



注:使用 --- 作為水平分割線時,要在它的前面空一行咳秉,防止 --- 被當成標題標記的表示方式婉支。

11.角標

語法:這里的角標內容會被放在文末,點擊角標可以實現(xiàn)跳轉澜建,點擊文末的返回按鈕即可返回角標磅摹,使用 [^] 來定義腳注。

  • 書寫格式
    這篇博客是有關MarkDown基本語法的博客[^1] 霎奢,希望以后繼續(xù)加油,多寫博客[^2]饼灿。
    [^1]:[球丁丁的第一篇學習博客]
    [^2]: [加油加油加油]

  • 解析效果
    這篇博客是有關MarkDown基本語法的博客[1] 幕侠,希望以后繼續(xù)加油,多寫博客[2]碍彭。

  • 文末截圖


    文末顯示的內容

12. 其他

反斜杠

有時候我們需要在文章中引用一些符號晤硕,為了避免這些符號被當作MarkDown標識符發(fā)生不必要的格式轉化,可以在符號前加 反斜杠\ 來避免庇忌。

  • 書寫格式
    \# 我不是一級標題
    \- 我不是無序列表
  • 解析效果

# 我不是一級標題
- 我不是無序列表
MarkDown 支持以下這些符號前面加上 反斜杠 來幫助插入普通的符號(表格來源)

符號 含義
\ 反斜杠
` 反引號
* 星號
_ 底線
{} 大括號
[] 方括號
() 括號
# 警號
+ - 加減號
. 英文句號
! 驚嘆號

最后推薦一個小游戲可以練習MarkDown基本語法http://commonmark.cn/help/tutorial/

參考資料

  1. [球丁丁的第一篇學習博客] ?

  2. [加油加油加油] ?

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯(lián)系作者
  • 序言:七十年代末舞箍,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子皆疹,更是在濱河造成了極大的恐慌疏橄,老刑警劉巖,帶你破解...
    沈念sama閱讀 211,884評論 6 492
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件略就,死亡現(xiàn)場離奇詭異捎迫,居然都是意外死亡,警方通過查閱死者的電腦和手機表牢,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 90,347評論 3 385
  • 文/潘曉璐 我一進店門窄绒,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人崔兴,你說我怎么就攤上這事彰导』壮幔” “怎么了?”我有些...
    開封第一講書人閱讀 157,435評論 0 348
  • 文/不壞的土叔 我叫張陵位谋,是天一觀的道長山析。 經常有香客問我,道長倔幼,這世上最難降的妖魔是什么盖腿? 我笑而不...
    開封第一講書人閱讀 56,509評論 1 284
  • 正文 為了忘掉前任,我火速辦了婚禮损同,結果婚禮上翩腐,老公的妹妹穿的比我還像新娘。我一直安慰自己膏燃,他們只是感情好茂卦,可當我...
    茶點故事閱讀 65,611評論 6 386
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著组哩,像睡著了一般等龙。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上伶贰,一...
    開封第一講書人閱讀 49,837評論 1 290
  • 那天蛛砰,我揣著相機與錄音,去河邊找鬼黍衙。 笑死泥畅,一個胖子當著我的面吹牛,可吹牛的內容都是我干的琅翻。 我是一名探鬼主播位仁,決...
    沈念sama閱讀 38,987評論 3 408
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼方椎!你這毒婦竟也來了聂抢?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 37,730評論 0 267
  • 序言:老撾萬榮一對情侶失蹤棠众,失蹤者是張志新(化名)和其女友劉穎琳疏,沒想到半個月后,有當地人在樹林里發(fā)現(xiàn)了一具尸體闸拿,經...
    沈念sama閱讀 44,194評論 1 303
  • 正文 獨居荒郊野嶺守林人離奇死亡轿亮,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 36,525評論 2 327
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發(fā)現(xiàn)自己被綠了胸墙。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片我注。...
    茶點故事閱讀 38,664評論 1 340
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖迟隅,靈堂內的尸體忽然破棺而出但骨,到底是詐尸還是另有隱情励七,我是刑警寧澤,帶...
    沈念sama閱讀 34,334評論 4 330
  • 正文 年R本政府宣布奔缠,位于F島的核電站掠抬,受9級特大地震影響,放射性物質發(fā)生泄漏校哎。R本人自食惡果不足惜两波,卻給世界環(huán)境...
    茶點故事閱讀 39,944評論 3 313
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望闷哆。 院中可真熱鬧腰奋,春花似錦、人聲如沸抱怔。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,764評論 0 21
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽屈留。三九已至局冰,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間灌危,已是汗流浹背康二。 一陣腳步聲響...
    開封第一講書人閱讀 31,997評論 1 266
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留勇蝙,地道東北人沫勿。 一個月前我還...
    沈念sama閱讀 46,389評論 2 360
  • 正文 我出身青樓,卻偏偏與公主長得像浅蚪,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子烫罩,可洞房花燭夜當晚...
    茶點故事閱讀 43,554評論 2 349

推薦閱讀更多精彩內容

  • 歡迎關注微信公眾號:北島向南(id:nanzhouie) GitHub Pages:https://zhouie....
    zhouie閱讀 4,847評論 4 72
  • 文字的發(fā)明和使用使得信息的保存和傳遞有了革命性的飛躍惜傲。隨著信息的豐富和傳遞方式的革新,人們對文本提出了新的格式化的...
    haoeric閱讀 7,514評論 1 16
  • 轉載自:https://www.cnblogs.com/crazyant007/p/4220066.html贝攒、 目...
    飛向深空閱讀 478評論 0 0
  • (小白入手必讀) 喜歡簡書的朋友盗誊,每天看著別人寫的文章,自己也總會有想去寫一些東西的沖動隘弊,可是面對簡書的文本編輯格...
    君不器12323閱讀 3,341評論 2 27
  • 勸君莫惜金縷衣哈踱,勸君惜取少年時±嫖酰花開堪折直須折开镣,莫待無花空折枝⊙噬龋——杜秋娘·金縷衣 這是一部比預期要沉重的影片邪财,新...
    潘慧敏閱讀 993評論 0 7