Markdown 簡易入門教程

目錄


<h2 id="overview">概述</h2>

<h3 id="summary">簡介</h3>

Markdown是一種輕量級標(biāo)記語言矢沿,排版語法簡潔酝枢,讓人們更多地關(guān)注內(nèi)容本身而非排版躺苦。它使用易讀易寫的純文本格式編寫文檔,可與HTML混編锨并,可導(dǎo)出 HTML、PDF 以及本身的 .md 格式的文件。因簡潔辛润、高效、易讀见秤、易寫砂竖,Markdown被大量使用,如Github鹃答、Wikipedia等網(wǎng)站乎澄,如各大博客平臺:WordPress、Drupal测摔、簡書等置济。

<h3 id="doc">官方文檔</h3>

Markdown: Syntax

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

<h3 id="editor">Markdown編輯器</h3>

  • 在線編輯器

    • dillinger——漂亮強(qiáng)大解恰,支持md, html, pdf 文件導(dǎo)出。

      dillinger
    • 簡書——非常漂亮的博客平臺浙于,可以自動備份护盈,直接拖入圖片。

      簡書
  • Windows

    • MarkdownPad——一款全功能的編輯器羞酗,被很多人稱贊為windows 平臺最好用的markdown編輯器腐宋。

      MarkdownPad
    • MarkPad——開源軟件,可以直接在你的博客或者 GitHub 中打開整慎、保存文檔脏款,直接將圖片粘貼到 Markdown 文檔中。

      MarkPad
    • Cmd Markdown——作業(yè)部落出品裤园,全平臺并支持Web端

      Cmd Markdown
  • Mac

    • Mou——簡潔優(yōu)雅撤师,免費(fèi)又好用,中文兼容性好拧揽。

      Mou
    • Typora——極致簡潔剃盾,自定義皮膚。

      Typora
    • MacDown——簡潔優(yōu)雅淤袜,開源免費(fèi)痒谴。

      MacDown
    • Ulysses——文字寫作推薦。

      Ulysses
  • 多平臺

    • Atom——github出的編輯器铡羡,支持各種編程語言积蔚,可裝Markdown插件。

    • sublimetext——專業(yè)編輯器烦周,支持各種編程語言尽爆。

<h2 id="primary">初級語法</h2>

<h3 id="MarkdownHeader">標(biāo)題</h3>

標(biāo)題

Markdown 支持兩種標(biāo)題的語法,類 Atx 和類 Setext 形式读慎。

  • Atx(注意#后面有個空格)

      # 一級標(biāo)題
      ## 二級標(biāo)題
      ### 三級標(biāo)題
    
  • Setext(-=數(shù)目任意漱贱,最好三個及以上,比較直觀)

      一級標(biāo)題
      ======
    
      二級標(biāo)題
      ------
    

<h3 id="bolditalic">粗體和斜體</h3>

bolditalic
  • 粗體

      **這是粗體**
    
      __這是粗體__
    
  • 斜體

      *這是斜體*
    
      _這是斜體_
    

<h3 id="paragraph">段落和換行</h3>

paragraph
  • 第一種寫法(上圖的這是第一段)夭委,直接敲兩個回車鍵即可

      這是第一段
      
      這是第二段
    
  • 第二種寫法(上圖的這是第二段)幅狮,在寫完一段后敲兩個空格,然后回車寫下一段

      這是第二段  
      這是第三段
    
  • 第三種寫法(上圖的這是第三段)株灸,在寫完一段后用HTML的語法:<br />作為換行崇摄,然后寫下一段

      這是第三段<br />這是第四段
      
      這是第三段<br />
      這是第四段
    

<h3 id="hr">分隔線</h3>

hr

可以在一行中用三個及以上的星號、減號慌烧、等于號配猫、底線來建立分隔線,行內(nèi)不能有除空格外的其他東西杏死,注意莫被打臉泵肄。 (? ? ?)?

***
---
===
___

<h3 id="blockquote">引言</h3>

blockquote
> 我想只用一個 “>” 號來寫一個多行的引用捆交,所以在扯雞巴蛋地碼字占空間,好像差不多了吧腐巢,嗯嗯~

---

> 還有一種寫法就是每一行都用一個 “>” 號
> 這樣寫比較美觀一點(diǎn)

---

> > 另外一種就是嵌套引用品追,就像我一樣,用兩個“>”

<h3 id="list">列表</h3>

<h4 id="disorderlist">無序列表</h4>

disorderlist

無序列表可以在每行開頭用星號冯丙、加號肉瓦、減號來表示,也可以三者混合一起胃惜,推薦使用相同的字符泞莉,避免混亂。

* 一朵百合花
* 兩朵百合花
* 三朵百合花

<h4 id="sorderlist">有序列表</h4>

orderlist

有序列表用數(shù)字接著一個英文句點(diǎn)來表示船殉,數(shù)字可無序鲫趁,但還是推薦使用1.2.利虫,避免混亂股毫。

1. 一朵百合花
2. 兩朵百合花
3. 三朵百合花

<h3 id="code">代碼</h3>

<h4 id="linecode">行內(nèi)代碼塊</h4>

linecode
I am a `code`
I am a `` ` ``

<h4 id="paragraphcode">段落代碼塊</h4>

paragraphcode
#### 第一種

    int main()
    {
        printf("我是個段落代碼塊");
        return 0;
    }

另外取视,可以用三個反引號和語言名浩螺,作為標(biāo)記代碼所使用的語言

paragraphcode2

我的 Mou 編輯器不能識別 (ノ▼Д▼)ノ

<h3 id="link">鏈接</h3>

<h4 id="urllink">網(wǎng)址鏈接</h4>

urllink

網(wǎng)址鏈接有兩種形式:行內(nèi)式姊途、參考式

不管是哪一種硼讽,鏈接文字都是用 [方括號] 來標(biāo)記巢价,雙引號""title可寫可不寫。

  • 行內(nèi)式

      [huihut](https://huihut.github.io/)
      
      [huihut](https://huihut.github.io/ "huihut")
      
      [huihut](https://huihut.github.io/ 'huihut')
    
  • 參考式

    • 一般寫法
        [huihut][1]
        [1]: https://huihut.github.io/
  • 隱式鏈接標(biāo)記——可省略id固阁,只需要[text]與下面[方括號]內(nèi)容相同即可
        [Google][]
        [Google]: http://google.com/
  • 拓展

    • 這里的鏈接辨別標(biāo)簽可以有字母壤躲、數(shù)字、空白和標(biāo)點(diǎn)符號您炉,但是并不區(qū)分大小寫,因此下面兩個鏈接是一樣的:

            [text][a]
            [text][A]
      
    • 鏈接 title 可以用雙引號役电、單引號赚爵、圓括號包起來,因此法瑟,下面這三種鏈接的定義都是相同:

            [1]: https://huihut.github.io/  "title"
            [1]: https://huihut.github.io/  'title'
            [1]: https://huihut.github.io/  (title)
      

特別注意:Markdown.pl 1.0.1 會忽略單引號包起來的鏈接 title

<h4 id="picturelink">圖片鏈接</h4>

picturelink

圖片鏈接與上面的網(wǎng)址鏈接類似冀膝,同樣有兩種形式:行內(nèi)式和參考式,只不過圖片鏈接在前面加上一個感嘆號!霎挟,在此不做累述窝剖。

  • 行內(nèi)式

      ![huihut](http://upload-images.jianshu.io/upload_images/4994492-7dda0710288c0db8.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
    
  • 參考式

      ![谷歌][1]
      [1]: https://www.google.com/images/branding/googlelogo/2x/googlelogo_color_120x44dp.png "Google"
    

<h5 id="picturelinksize">指定圖片寬高</h5>

  • Markdown 一般不支持指定圖片的寬高,若要指定寬高可以使用普通的 <img> 標(biāo)簽

      ![](./xxx.png)
    

    如果需要居中可以在外圍包圍div標(biāo)簽

      <div  align="center">    
      ![](xxx.png)
      </div>
    
  • 使用支持指定圖片大小的 Markdown 編輯器酥夭,如 Mou

      ![](xxx.png =100x100)
    

<h5 id="picturelinkchain">用圖床獲取外鏈</h5>

網(wǎng)上有許多圖床赐纱,這里推薦兩個 七牛圖床極簡圖床脊奋。

<h2 id="Advanced">進(jìn)階語法</h2>

<h3 id="label">標(biāo)簽</h3>

label
  • 方法一

      title: Markdown 簡易入門教程
      date: 2017-01-25 1:45:50
      tags: Markdown
      categories: 技術(shù)
    
  • 方法三

      tags:
      - Markdown
      - 語言
      categories:
      - 技術(shù)
    
  • 方法三

      tags: [Markdown,語言]
      categories: [技術(shù)]
    

<h3 id="content">目錄</h3>

  • 方法一

    這種目錄其實(shí)是用 HTMLMarkdown的鏈接 實(shí)現(xiàn),分為兩個部分疙描,目錄部分標(biāo)題部分诚隙。

    • 目錄部分——實(shí)質(zhì)是鏈接,鏈接的[地址]填需要跳轉(zhuǎn)到的標(biāo)題的id屬性(自定義)起胰。

        [跳到標(biāo)題一](#title1)
      
    • 標(biāo)題部分——實(shí)質(zhì)是HTML的標(biāo)題標(biāo)簽久又,標(biāo)簽里面的id屬性等于待跳轉(zhuǎn)的目錄的[地址]

        <h1 id="title1">標(biāo)題一</h1>
      
  • 方法二

    content2

    這種方法非常簡單效五,就是直接添加 [TOC]地消,標(biāo)題1~6樣式的內(nèi)容會被提取出來作為目錄,然而有些編輯器不能使用這功能畏妖,如 Mou 不能使用脉执。我是在有道云筆記的 Markdown 中截圖的。

      [TOC]
      
      # 標(biāo)題一
      ……
      ## 標(biāo)題二
      ……
      ### 標(biāo)題三
    

    這里有個jQuery插件瓜客,貌似可以讓Markdown生成目錄:

    https://github.com/i5ting/i5ting_ztree_toc

<h3 id="table">表格</h3>

table
  • 表格一般這樣子寫适瓦,這應(yīng)該是最簡單的寫法了

      id    |   name   |   score
      ---   |   ---    |   ---
      001   |   Mark   |   90
      002   |   Ford   |   80
      003   |   Alan   |   95
    
  • 還有就是對齊了,用:對齊谱仪,:寫在在---的左邊就是左對齊玻熙,右邊就是右對齊,兩邊都寫就是居中疯攒。

      |long_long_id|long_long_name|long_long_score|
      |    ---     |    :---:     |     ---:      |
      |    001     |     Mark     |      90       |
      |    002     |     Ford     |      80       |
      |    003     |     Alan     |      95       |
    

<h3 id="footnote">腳注</h3>

footnote
這是腳注一[^1]

[^1]: 腳注一

<h3 id="formula">公式</h3>

formula
  • 方法一:使用Google Chart

      ![](http://chart.googleapis.com/chart?cht=tx&chl=\Large x=\frac{-b\pm\sqrt{b^2-4ac}}{2a})
    
  • 方法二:使用forkosh

      ![](http://chart.googleapis.com/chart?cht=tx&chl=\Large x=\frac{-b\pm\sqrt{b^2-4ac}}{2a})
    
  • 方法三:使用codecogs

      <a  target="_blank">![x=\frac{-b\pm \sqrt{b^{2}-4ac}}{2a}](https://latex.codecogs.com/gif.latex?x=\frac{-b\pm&space;\sqrt{b^{2}-4ac}}{2a})</a>
    
  • 方法四:使用MathJax引擎——先加載腳本<script>嗦随,后解析公式。

      <script type="text/javascript" src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=default"></script>
      
      $$x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}$$
    

<h3 id="flowsheet">流程圖</h3>

flowsheet

像流程圖這種復(fù)雜的功能不推薦在 Markdown 中使用敬尺,因?yàn)楹芏嗑庉嬈鞫疾恢С置赌幔沂褂昧藥讉€編輯器都不能生成流程圖,所以上圖是在為知筆記官方 Markdown 新手指南中找到的砂吞。

flowsheetcode
```flow
st=>start: Start
e=>end: End
op1=>operation: My Operation
sub1=>subroutine: My Subroutine
cond=>condition: Yes or No?
io=>inputoutput: catch something...
st->op1->cond
cond(yes)->io->e
cond(no)->sub1(right)->op1
```

更多關(guān)于流程圖的語法說明:

https://github.com/adrai/flowchart.js

<h3 id="sequencemap">序列圖</h3>

sequencemap
sequencemapcode
```sequence
Alice->Bob: Hello Bob, how are you?
Note right of Bob: Bob thinks
Bob-->Alice: I am good thanks!
```

更多關(guān)于時序圖的語法說明:

https://github.com/bramp/js-sequence-diagrams

<h2 id="others">其他語法</h2>

<h3 id="html">兼容HTML</h3>

html

Markdown 可以和 HTML 混編署恍,甚至可以完全用 HTML 語法來寫。要注意在 HTML 標(biāo)簽中的 Markdown 代碼是不起作用的蜻直。

<font color='blue' style='font-size:30px'>藍(lán)色</font>

<div>
# HTML 標(biāo)簽里面的 Markdown 語法不起作用
**你看我沒有變粗**
</div>

<h3 id="autoescape">特殊字符自動轉(zhuǎn)換</h3>

  • HTML 語法——在 HTML 中所有<&都要轉(zhuǎn)換盯质,包括鏈接(URL)

    • < 表示 <——起始標(biāo)簽
    • & 表示 & ——標(biāo)記 HTML 實(shí)體
  • Markdown 語法——Markdown 則會自動轉(zhuǎn)換

<h3 id="backslash">反斜杠</h3>

Markdown 可以利用反斜杠來插入一些在語法中有其它意義的符號。如:

*literal asterisks*

可用

\*literal asterisks\*

Markdown 支持以下這些符號前面加上反斜杠來幫助插入普通的符號:

\   反斜線
`   反引號
*   星號
_   底線
{}  花括號
[]  方括號
()  括弧
#   井字號
+   加號
-   減號
.   英文句點(diǎn)
!   驚嘆號

<h3 id="autolink">自動鏈接</h3>

autolink
  • 網(wǎng)址自動鏈接

      <https://huihut.github.io/>
    
  • 電子郵件自動鏈接

      <huihut@outlook.com>
    

<h2 id="reference">參考</h2>

Markdown: Syntax

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

Markdown——入門指南

Markdown語法手冊

好用的Markdown編輯器一覽

markdown中插入圖片怎么定義圖片的大小或比例概而?

Markdown進(jìn)階語法整理

為知筆記 Markdown 新手指南

Markdown中插入數(shù)學(xué)公式的方法

i5ting/i5ting_ztree_toc

flowchart.js

adrai/flowchart.js

js-sequence-diagrams

bramp/js-sequence-diagrams


我的博客:https://blog.huihut.com/
轉(zhuǎn)載請注明出處:https://blog.huihut.com/2017/01/25/MarkdownTutorial/

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末呼巷,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子赎瑰,更是在濱河造成了極大的恐慌王悍,老刑警劉巖,帶你破解...
    沈念sama閱讀 216,402評論 6 499
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件餐曼,死亡現(xiàn)場離奇詭異压储,居然都是意外死亡鲜漩,警方通過查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,377評論 3 392
  • 文/潘曉璐 我一進(jìn)店門渠脉,熙熙樓的掌柜王于貴愁眉苦臉地迎上來宇整,“玉大人,你說我怎么就攤上這事芋膘×矍啵” “怎么了?”我有些...
    開封第一講書人閱讀 162,483評論 0 353
  • 文/不壞的土叔 我叫張陵为朋,是天一觀的道長臂拓。 經(jīng)常有香客問我,道長习寸,這世上最難降的妖魔是什么胶惰? 我笑而不...
    開封第一講書人閱讀 58,165評論 1 292
  • 正文 為了忘掉前任,我火速辦了婚禮霞溪,結(jié)果婚禮上孵滞,老公的妹妹穿的比我還像新娘。我一直安慰自己鸯匹,他們只是感情好坊饶,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,176評論 6 388
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著殴蓬,像睡著了一般匿级。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上染厅,一...
    開封第一講書人閱讀 51,146評論 1 297
  • 那天痘绎,我揣著相機(jī)與錄音,去河邊找鬼肖粮。 笑死孤页,一個胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的涩馆。 我是一名探鬼主播行施,決...
    沈念sama閱讀 40,032評論 3 417
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼凌净!你這毒婦竟也來了悲龟?” 一聲冷哼從身側(cè)響起屋讶,我...
    開封第一講書人閱讀 38,896評論 0 274
  • 序言:老撾萬榮一對情侶失蹤冰寻,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后皿渗,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體斩芭,經(jīng)...
    沈念sama閱讀 45,311評論 1 310
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡轻腺,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,536評論 2 332
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發(fā)現(xiàn)自己被綠了划乖。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片贬养。...
    茶點(diǎn)故事閱讀 39,696評論 1 348
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖琴庵,靈堂內(nèi)的尸體忽然破棺而出误算,到底是詐尸還是另有隱情,我是刑警寧澤迷殿,帶...
    沈念sama閱讀 35,413評論 5 343
  • 正文 年R本政府宣布儿礼,位于F島的核電站,受9級特大地震影響庆寺,放射性物質(zhì)發(fā)生泄漏蚊夫。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,008評論 3 325
  • 文/蒙蒙 一懦尝、第九天 我趴在偏房一處隱蔽的房頂上張望知纷。 院中可真熱鬧,春花似錦陵霉、人聲如沸琅轧。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,659評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽鹰晨。三九已至,卻和暖如春止毕,著一層夾襖步出監(jiān)牢的瞬間模蜡,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 32,815評論 1 269
  • 我被黑心中介騙來泰國打工扁凛, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留忍疾,地道東北人。 一個月前我還...
    沈念sama閱讀 47,698評論 2 368
  • 正文 我出身青樓谨朝,卻偏偏與公主長得像卤妒,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子字币,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,592評論 2 353

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