Markdown 語法入門

Markdown

Markdown作為一種使用普通文本編輯器編寫的標記語言,通過簡單的標記語法诡壁,設置文本不同的格式济瓢。以實現(xiàn) [易讀易寫] 的目標。

Markdown為編寫HTML提供了很好的實現(xiàn)妹卿,并避免了伴隨的復雜性和丑陋難看旺矾。Markdown的語法全由一些符號組成,語法簡單易上手夺克。

本文介紹Markdown語法入門箕宙。

一、語法介紹

1.1 標題

1.1.1 Setext形式

類Setext形式是用底線的形式铺纽,利用 = (最高階標題) 和 - (第二階標題)柬帕,例如:

This is H1
===========
This is H2
-------------------

This is H1

This is H2

注意:其中,任何數(shù)量的 =- 都是等效的狡门。

1.1.2 Atx形式

類Atx形式是在行首插入 1 到 6個 #陷寝,對應分別為標題 16 階,例如:

# H1 #
## H2 ##
### H3 ###
#### H4 ####
##### H5 #####
##### H6 #####

H1

H2

H3

H4

H5
H6

通常其馏,若為了美觀用凤跑,可以在行尾加上 #,行尾的 # 不強制要求和開頭一樣叛复,只有行首的字符數(shù)確定標題對應的階數(shù)仔引。

1.2 區(qū)塊引用Blockquotes

Markdown 標記區(qū)塊引用類似email中用 > 的引用方式。在每行的前面加上 >褐奥。
同樣咖耘,Markdown允許只在整個段落的第一行最前加上 >
區(qū)塊引用也可以嵌套撬码,根據(jù)不同層次加上不同數(shù)量的 > 即可儿倒。
引用的區(qū)塊內同樣可以使用其他Markdown 語法,包括標題耍群,列表义桂,代碼區(qū)塊等找筝。

> 區(qū)塊引用...
>
> 區(qū)塊引用...

> 段落只需要要在第一行加上 
整個段落即引用在區(qū)塊內蹈垢。

> 區(qū)塊間引用
>> 區(qū)塊間引用

> ### 引用其他語法

區(qū)塊引用...

區(qū)塊引用...

段落只需要要在第一行加上
整個段落即引用在區(qū)塊內。

區(qū)塊間引用

區(qū)塊間引用

引用其他語法

1.3 列表

Markdown支持有序列表和無序列表袖裕。

1.3.1 有序列表

有序列表使用1.數(shù)字接著一個英文句點曹抬;特別注意的是在標記上使用的數(shù)字并不會影響輸出結果;列表項還可以包含多個段落急鳄,每個列表下段落都必須縮進4個空格或者1個制表符谤民;如果需要在列表項目內引用的時候堰酿,使用 > 需要縮進。例如如下語法:

1.   item 1
3.   item 2(標記上使用的數(shù)字并不會影響輸出結果)
2.   item 3(標記上使用的數(shù)字并不會影響輸出結果)
4.   item 4
      多段文字1
      多段文字1
      >區(qū)塊引用
5.  item 5
    1.列表項目內加列表
  1. item 1
  1. item 2(標記上使用的數(shù)字并不會影響輸出結果)
  2. item 3(標記上使用的數(shù)字并不會影響輸出結果)
  3. item 4
    多段文字1
    多段文字1

    區(qū)塊引用

  4. item 5
    1.列表項目內加列表

1.3.2 無序列表

無序列表使用 *(星號)张足、+(加好) 以及 -(減號)作為列表標記:

- item 1
+ item 2
* item 3
  - item 3.1
    - item 3.1.1
  • item 1
  • item 2
  • item 3
    • item 3.1
      • item 3.1.1

1.4 代碼區(qū)塊

和程序相關的寫作通常會用到代碼區(qū)塊触创,如果用區(qū)塊引用排版就會和代碼排版有差異,而我們更希望是按照原來的樣子顯示为牍。Markdown 通過 <code>`</code> 和 <code>```</code> 標簽來把代碼區(qū)塊包起來哼绑。

在代碼區(qū)塊里, & 碉咆、<>會自動轉換成HTML試題抖韩,這樣讓諸如插入范例使用的HTML原始碼更方便了。

 <div class="footer">
        ? 2004 Foo Corporation
 </div>

在代碼區(qū)塊中疫铜,一般的Markdown語法不會被轉換茂浮,因此可以很容易的用Markdown語法撰寫相關語法文檔。

1.5 分割線

在任意一行中用三個以上的 *壳咕、-以及_來建立分割線席揽,行內不能有除空格外的其他內容。

1.6 特殊格式

1.6.1 粗體

粗體文字設置使用 **將目標文字包含起來谓厘。

Bold

1.6.2 斜體

斜體文字設置使用 _將目標文字包含起來驹尼。

Italics

1.6.3 刪除線

斜體文字設置使用 ~~ 將目標文字包含起來。

strikethrough

1.6.4 語法高亮

特定語法用如<code>```js</code>將設置超鏈接的文字包含起來庞呕。

grunt.initConfig({
  assemble: {
    options: {
      assets: 'docs/assets',
      data: 'src/data/*.{json,yml}',
      helpers: 'src/custom-helpers.js',
      partials: ['src/partials/**/*.{hbs,md}']
    },
    pages: {
      options: {
        layout: 'default.hbs'
      },
      files: {
        './': ['src/templates/pages/index.hbs']
      }
    }
  }
};

1.7 表格

1.7.1 普通表格

表格通過 |-表示新翎。表頭需要和表內容用 - 分割,各列內容用 | 分割住练。注意地啰,不需要垂直對齊。

|table1|table2|
|--------|-------|
|content1|content2|
table1 table2
content1 content2

1.7.1 特殊格式表格

在表頭內容分割線結束加上 : 即表示文字靠右對齊讲逛。

|table1|table2|
|--------:|-------:|
|content1|content2|
table1 table2
content1 content2

1.8 超鏈接

超鏈接通過 [ 超鏈接文字 ] 包含超鏈接文字內容亏吝,并在后緊跟 (URL) 超鏈接地址。

[Link](http://www.reibang.com/u/7f8d85055cd1)

當需要為超鏈接添加hover效果的時候盏混,在 (URL "hoverTitle") URL后用 "" 將提示文字包含起來蔚鸥。

[Link](http://www.reibang.com/u/7f8d85055cd1 "Burjal")

1.9 Named Anchors

Named Anchors使能夠在相同的頁面上跳轉到指定的錨點。最常用的就是跳轉到每一個章節(jié)许赃。

# Table of Contents
  * [Chapter 1](#chapter-1)
  * [Chapter 2](#chapter-2)
  * [Chapter 3](#chapter-3)

Table of Contents

上述會跳轉到對應如下位置:

## Chapter 1 <a id="chapter-1"></a>
Content for chapter one.

## Chapter 2 <a id="chapter-2"></a>
Content for chapter one.

## Chapter 3 <a id="chapter-3"></a>
Content for chapter one.

1.20 圖片

圖片的語法和超鏈接的語法類似止喷,在超鏈接語法前加了 !

![Markdown](http://upload-images.jianshu.io/upload_images/311578-26c2869134c4e359.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
Markdown

二混聊、簡書設置默認編輯器:

簡書已經支持Markdown語法編輯弹谁。
設置步驟如下:

設置

在首頁找到并進入設置。

設置常用編輯器

將常用編輯器設置為 Markdown

Markdown 語法入門分析到此就結束了~

附:

Grav SYNTAX

Markdown 語法說明 (簡體中文版)

Markdown: Basics(快速入門)

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯(lián)系作者
  • 序言:七十年代末预愤,一起剝皮案震驚了整個濱河市沟于,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌植康,老刑警劉巖旷太,帶你破解...
    沈念sama閱讀 211,042評論 6 490
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異销睁,居然都是意外死亡泳秀,警方通過查閱死者的電腦和手機,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 89,996評論 2 384
  • 文/潘曉璐 我一進店門榄攀,熙熙樓的掌柜王于貴愁眉苦臉地迎上來嗜傅,“玉大人,你說我怎么就攤上這事檩赢÷类郑” “怎么了?”我有些...
    開封第一講書人閱讀 156,674評論 0 345
  • 文/不壞的土叔 我叫張陵贞瞒,是天一觀的道長偶房。 經常有香客問我,道長军浆,這世上最難降的妖魔是什么棕洋? 我笑而不...
    開封第一講書人閱讀 56,340評論 1 283
  • 正文 為了忘掉前任,我火速辦了婚禮乒融,結果婚禮上掰盘,老公的妹妹穿的比我還像新娘。我一直安慰自己赞季,他們只是感情好愧捕,可當我...
    茶點故事閱讀 65,404評論 5 384
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著申钩,像睡著了一般次绘。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 49,749評論 1 289
  • 那天,我揣著相機與錄音撒璧,去河邊找鬼。 笑死辙培,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 38,902評論 3 405
  • 文/蒼蘭香墨 我猛地睜開眼命迈,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了火的?” 一聲冷哼從身側響起壶愤,我...
    開封第一講書人閱讀 37,662評論 0 266
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎馏鹤,沒想到半個月后征椒,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經...
    沈念sama閱讀 44,110評論 1 303
  • 正文 獨居荒郊野嶺守林人離奇死亡湃累,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 36,451評論 2 325
  • 正文 我和宋清朗相戀三年勃救,在試婚紗的時候發(fā)現(xiàn)自己被綠了。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片治力。...
    茶點故事閱讀 38,577評論 1 340
  • 序言:一個原本活蹦亂跳的男人離奇死亡蒙秒,死狀恐怖,靈堂內的尸體忽然破棺而出宵统,到底是詐尸還是另有隱情晕讲,我是刑警寧澤,帶...
    沈念sama閱讀 34,258評論 4 328
  • 正文 年R本政府宣布马澈,位于F島的核電站瓢省,受9級特大地震影響,放射性物質發(fā)生泄漏痊班。R本人自食惡果不足惜勤婚,卻給世界環(huán)境...
    茶點故事閱讀 39,848評論 3 312
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望涤伐。 院中可真熱鬧馒胆,春花似錦、人聲如沸凝果。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,726評論 0 21
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽豆村。三九已至液兽,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間掌动,已是汗流浹背四啰。 一陣腳步聲響...
    開封第一講書人閱讀 31,952評論 1 264
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留粗恢,地道東北人柑晒。 一個月前我還...
    沈念sama閱讀 46,271評論 2 360
  • 正文 我出身青樓,卻偏偏與公主長得像眷射,于是被迫代替她去往敵國和親匙赞。 傳聞我的和親對象是個殘疾皇子佛掖,可洞房花燭夜當晚...
    茶點故事閱讀 43,452評論 2 348

推薦閱讀更多精彩內容

  • 標題 Markdown支持兩種標題的語法,類Setext和類atx形式涌庭。 類Setext 使用底線的形式芥被,利用 =...
    禾邊的曉作坊閱讀 708評論 0 5
  • MarkDown簡介 Markdown是一種輕量級標記語言,創(chuàng)始人為John Gruber和Aaron Swart...
    葉子的翅膀閱讀 1,278評論 0 1
  • 玉兒到食堂吃飯坐榆,一如往常的取了兩個碗拴魄,到燒水區(qū)用開水燙一下碗,讓自己覺得碗會變得干凈點席镀,吃著放心點匹中,新來的同事小...
    菊小趙閱讀 148評論 3 1
  • 簡單書寫,世界美麗
    也竹閱讀 206評論 0 0
  • 北京夏日豪诲。伏天里的一場雨后顶捷。潮濕涼滑的清晨,又見一季金合歡樹屎篱,盛開繁花焊切。俏麗鮮艷的紅傘向天盛開著。 不...
    魚沒沒閱讀 212評論 0 0