Markdown語(yǔ)法

本文主要內(nèi)容包括:markdwon的基本語(yǔ)法和使用技巧。

相關(guān)文檔


概述


宗旨

易讀易寫

編輯工具

  • Mou
    Mac OS X 系統(tǒng)可以使用雁仲,支持實(shí)時(shí)預(yù)覽功能
  • Atom
    多端可以使用凤藏,就是效率很低球凰。有時(shí)候很卡。
  • 簡(jiǎn)書
    Web端使用簡(jiǎn)書編輯也是不錯(cuò)的選擇。可以保存在云端扬跋。

兼容 HTML

  • 區(qū)塊元素(<div> <table> <pre> <p>)
    這是一個(gè)普通的段落。
    <table>
      <tr>
        <td>*Hello*</td>
        <td>Word</td>
      </tr>
    </table>
    這是另外一個(gè)段落凌节。
    
    這是一個(gè)普通的段落钦听。
    <table><tr><td>Hello</td><td>Word</td></tr></table>
    這是另外一個(gè)段落。
  • HTML 區(qū)塊標(biāo)簽間的 Markdown 格式語(yǔ)法將不會(huì)被處理
  • 行內(nèi)標(biāo)簽(<span> <cite> <del>)可以隨意使用
  • <a> <img>可以直接使用
<a >百度</a>

<a >百度</a>

  • 特殊字符自動(dòng)轉(zhuǎn)換
      AT&T
      ?
    
    AT&T
    ?

基本符號(hào)


  • *,-,+ 3個(gè)符號(hào)效果都一樣倍奢,這3個(gè)符號(hào)被稱為Markdown符號(hào)
  • 空白行表示另起一個(gè)段落
  • `是表示inline代碼朴上,tab是用來(lái)標(biāo)記 代碼段,分別對(duì)應(yīng)html的code卒煞,pre標(biāo)簽

區(qū)塊元素


段落和換行

段落是由前后一個(gè)以上的空行產(chǎn)生的痪宰,普通段落不該用空格或制表符來(lái)縮進(jìn)。

標(biāo)題

  • Setext 形式

    這是 H1
    =============
    這是 H2
    -------------
    
  • atx 形式

    # 這是 H1
    ## 這是 H2
    ###### 這是 H6
    

區(qū)塊引用 Blockquotes

> 這是一個(gè)區(qū)塊引用
  Markdown 也允許你偷懶只在整個(gè)段落的第一行最前面加上 >
>> 區(qū)塊引用可以嵌套
>>> 區(qū)塊引用可以嵌套  
>>> - 這是第一行列表項(xiàng)畔裕。
>>> - 這是第二行列表項(xiàng)衣撬。

>> 區(qū)塊引用可以嵌套

> 區(qū)塊引用可以嵌套

這是一個(gè)區(qū)塊引用
Markdown 也允許你偷懶只在整個(gè)段落的第一行最前面加上 >

區(qū)塊引用可以嵌套

區(qū)塊引用可以嵌套

  • 這是第一行列表項(xiàng)。
  • 這是第二行列表項(xiàng)扮饶。

區(qū)塊引用可以嵌套

區(qū)塊引用可以嵌套

列表

無(wú)序列表使用星號(hào)淮韭、加號(hào)或是減號(hào)作為列表標(biāo)記:

  *   Red
  -   Green
  +   Blue  
  • Red
  • Green
  • Blue

有序列表則使用數(shù)字接著一個(gè)英文句點(diǎn)

1. Bird  
  第二段  
  第三段

2. McHale
  > 這是一個(gè)區(qū)塊引用
  > 這是一個(gè)區(qū)塊引用
3. Parish
4. 一列表項(xiàng)包含一個(gè)列表區(qū)塊:  
  <代碼寫在這>
1986. 有序列表前面的序號(hào)不起作用
1986\. 避免這種`數(shù)字-句點(diǎn)-空白`生成列表
  1. Bird
    第二段
    第三段

  2. McHale

這是一個(gè)區(qū)塊引用
這是一個(gè)區(qū)塊引用

  1. Parish
  2. 一列表項(xiàng)包含一個(gè)列表區(qū)塊:
    代碼寫在這
  3. 有序列表前面的序號(hào)不起作用
    1986. 避免這種數(shù)字-句點(diǎn)-空白生成列表

代碼區(qū)塊

markdwon語(yǔ)法

縮進(jìn) 4 個(gè)空格或是 1 個(gè)制表符

這是一個(gè)普通段落:

    這是一個(gè)代碼區(qū)塊。

      import java.io.*;

這是一個(gè)普通段落:

這是一個(gè)代碼區(qū)塊贴届。

import java.io.*;
<div class="footer">
  ? 2004 Foo Corporation
</div>  
  `這是一個(gè)代碼區(qū)塊`

這是一個(gè)代碼區(qū)塊

<pre>
'''
這是一個(gè)代碼區(qū)塊
'''
</pre>

  這是一個(gè)代碼區(qū)塊
html方式

<pre> <code>

分隔線

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




表格(擴(kuò)展的markdown才支持)

注意冒號(hào)是對(duì)齊方式

| Tablees    | Are           | Coll  |
| ----------:|:-------------:|:------|
| col 3 is   | right-aligned | $160  |
| col 2 is   | centered      | $12   |
| col 2 is   | centered      | $12   |
Tablees Are Coll
col 3 is right-aligned $160
col 2 is centered $12
col 2 is centered $12

流程圖

參考

  st=>start: Start
  i=>inputoutput: 輸入年份n
  cond1=>condition: n能否被4整除?
  cond2=>condition: n能否被100整除?
  cond3=>condition: n能否被400整除毫蚓?
  o1=>inputoutput: 輸出非閏年
  o2=>inputoutput: 輸出非閏年
  o3=>inputoutput: 輸出閏年
  o4=>inputoutput: 輸出閏年
  e=>end
  st->i->cond1
  cond1(no)->o1->e
  cond1(yes)->cond2
  cond2(no)->o3->e
  cond2(yes)->cond3
  cond3(yes)->o2->e
  cond3(no)->o4->e

插入LaTeX公式

參考

  • 使用MathJax引擎
<script type="text/javascript"  
        src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=default">
</script>

使用Tex寫公式占键。$$公式$$表示行間公式,本來(lái)Tex中使用(公式)表示行內(nèi)公式元潘,但因?yàn)镸arkdown中\(zhòng)是轉(zhuǎn)義字符畔乙,所以在Markdown中輸入行內(nèi)公式使用\(公式\),如下代碼:

  $$x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}$$
  \\(x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}\\)

$$x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}$$
\(x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}\)

區(qū)段元素


強(qiáng)調(diào)

*斜體* _斜體_
**粗體** __粗體__
~~刪除線~~
<u>下劃線</u>
上標(biāo)<sup>2</sup>
下標(biāo)<sub>2</sub>

斜體 斜體
粗體 粗體
刪除線
<u>下劃線</u>
上標(biāo)2
下標(biāo)2

鏈接

  • 行內(nèi)式

    這是一個(gè)[行內(nèi)式的鏈接](http://tech.xchance.xyz "可選的title")
    這是一個(gè)[相對(duì)路徑的連鏈接](/about "可選的title")
    

    這是一個(gè)行內(nèi)式的鏈接
    這是一個(gè)相對(duì)路徑的連鏈接

  • 參考式
    這是一個(gè)[參考式的連接] [1]
    [1]: http://tech.xchance.xyz "Github 個(gè)人主頁(yè)"
    [2]: <http://tech.xchance.xyz> "Github 個(gè)人主頁(yè)"
    [3]: http://tech.xchance.xyz 'Github 個(gè)人主頁(yè)'
    [4]: http://tech.xchance.xyz (Github 個(gè)人主頁(yè))
    參考式的連接
    隱式鏈接標(biāo)記:[Google Address][]
    [Google Address]: http://google.com/

    [Google Address][]
    [Google Address]: http://google.com/
    [id]: http://tech.xchance.xyz

  • 簡(jiǎn)寫Url

    <http://tech.xchance.xyz>
    <catchance@163.com>
    

    http://tech.xchance.xyz
    catchance@163.com

圖片

類似鏈接方式同樣支持行內(nèi)式翩概、參考式<img>
hexo好像不支持可選文字

  ![Alt text](http://tech.xchance.xyz/favicon.ico)
  ![Alt text](http://tech.xchance.xyz/favicon.ico)
  ![Alt text][id]
  [id]: url/to/image  "Optional title attribute"
Alt text
Alt text

Alt text
Alt text

注腳

原始Markdown語(yǔ)法好像不支持牲距,不過(guò)有些Blog是支持的

  這是一個(gè)注腳[^footer]
  [^footer]: 這是一個(gè)注腳

這是一個(gè)注腳 [1]

頁(yè)內(nèi)跳轉(zhuǎn)

  定義錨點(diǎn): <span id="jump"> hello world </span>
  使用錨點(diǎn): [hello](#jump)

定義錨點(diǎn): <span id="jump"> hello world </span>
使用錨點(diǎn): hello

技巧


  • 使用兩個(gè)以上的空格然后回車插入<br /> 標(biāo)簽
  • 特殊字符需要\字符來(lái)轉(zhuǎn)義:
    \ ` * _ {} [] () # + - . !
  • 如果要在代碼區(qū)段內(nèi)插入反引號(hào),你可以用多個(gè)反引號(hào)來(lái)開(kāi)啟和結(jié)束代碼區(qū)段
  代碼塊中插入反引號(hào):`` ` ``

代碼塊中插入反引號(hào):`

  • 段首縮進(jìn)技巧:
    切換到全角模式下(一般的中文輸入法都是按 shift + space)輸入兩個(gè)空格就行了
  • 文章中插入注釋的話钥庇,可以使用``

名詞解釋


<span id ="ref1">空行</span> 顯示上看起來(lái)像是空的牍鞠,便會(huì)被視為空行。比方說(shuō)评姨,若某一行只包含空格和制表符难述,則該行也會(huì)被視為空行


  1. 這是一個(gè)注腳 ?

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市吐句,隨后出現(xiàn)的幾起案子胁后,更是在濱河造成了極大的恐慌,老刑警劉巖嗦枢,帶你破解...
    沈念sama閱讀 218,755評(píng)論 6 507
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件攀芯,死亡現(xiàn)場(chǎng)離奇詭異,居然都是意外死亡文虏,警方通過(guò)查閱死者的電腦和手機(jī)侣诺,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,305評(píng)論 3 395
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái)择葡,“玉大人紧武,你說(shuō)我怎么就攤上這事∶舸ⅲ” “怎么了阻星?”我有些...
    開(kāi)封第一講書人閱讀 165,138評(píng)論 0 355
  • 文/不壞的土叔 我叫張陵,是天一觀的道長(zhǎng)已添。 經(jīng)常有香客問(wèn)我妥箕,道長(zhǎng),這世上最難降的妖魔是什么更舞? 我笑而不...
    開(kāi)封第一講書人閱讀 58,791評(píng)論 1 295
  • 正文 為了忘掉前任畦幢,我火速辦了婚禮,結(jié)果婚禮上缆蝉,老公的妹妹穿的比我還像新娘宇葱。我一直安慰自己瘦真,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,794評(píng)論 6 392
  • 文/花漫 我一把揭開(kāi)白布黍瞧。 她就那樣靜靜地躺著诸尽,像睡著了一般。 火紅的嫁衣襯著肌膚如雪印颤。 梳的紋絲不亂的頭發(fā)上您机,一...
    開(kāi)封第一講書人閱讀 51,631評(píng)論 1 305
  • 那天,我揣著相機(jī)與錄音年局,去河邊找鬼际看。 笑死,一個(gè)胖子當(dāng)著我的面吹牛矢否,可吹牛的內(nèi)容都是我干的仲闽。 我是一名探鬼主播,決...
    沈念sama閱讀 40,362評(píng)論 3 418
  • 文/蒼蘭香墨 我猛地睜開(kāi)眼兴喂,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼蔼囊!你這毒婦竟也來(lái)了?” 一聲冷哼從身側(cè)響起衣迷,我...
    開(kāi)封第一講書人閱讀 39,264評(píng)論 0 276
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤畏鼓,失蹤者是張志新(化名)和其女友劉穎,沒(méi)想到半個(gè)月后壶谒,有當(dāng)?shù)厝嗽跇?shù)林里發(fā)現(xiàn)了一具尸體云矫,經(jīng)...
    沈念sama閱讀 45,724評(píng)論 1 315
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,900評(píng)論 3 336
  • 正文 我和宋清朗相戀三年汗菜,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了让禀。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 40,040評(píng)論 1 350
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡陨界,死狀恐怖巡揍,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情菌瘪,我是刑警寧澤腮敌,帶...
    沈念sama閱讀 35,742評(píng)論 5 346
  • 正文 年R本政府宣布,位于F島的核電站俏扩,受9級(jí)特大地震影響糜工,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜录淡,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,364評(píng)論 3 330
  • 文/蒙蒙 一捌木、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧嫉戚,春花似錦刨裆、人聲如沸澈圈。這莊子的主人今日做“春日...
    開(kāi)封第一講書人閱讀 31,944評(píng)論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)极舔。三九已至,卻和暖如春链瓦,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背盯桦。 一陣腳步聲響...
    開(kāi)封第一講書人閱讀 33,060評(píng)論 1 270
  • 我被黑心中介騙來(lái)泰國(guó)打工慈俯, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人拥峦。 一個(gè)月前我還...
    沈念sama閱讀 48,247評(píng)論 3 371
  • 正文 我出身青樓贴膘,卻偏偏與公主長(zhǎng)得像,于是被迫代替她去往敵國(guó)和親略号。 傳聞我的和親對(duì)象是個(gè)殘疾皇子刑峡,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,979評(píng)論 2 355

推薦閱讀更多精彩內(nèi)容