Markdown基本語法

提到Markdown柴信,很多人首先想到的是簡單套啤、Easy等等。的確随常,Markdown為簡單而生潜沦。Markdown是由一個叫 JOHN GRUBER 的哥們發(fā)明的,它的語法用一篇文章就可以說完线罕。不相信嗎止潮?讓我們來試試看...

markdown介紹

Markdown是一種可以使用普通文本編輯器編寫的標記語言,通過簡單的標記語法钞楼,它可以使普通文本內(nèi)容具有一定的格式喇闸。
Markdown語法的目標是:成為一種適用于網(wǎng)絡(luò)的書寫語言「易讀易寫」。并且Markdown兼容HTML询件。這個還是很nice的燃乍。??

想要學習更多關(guān)于Markdown的內(nèi)容,傳送門??
http://www.appinn.com/markdown/

基礎(chǔ)語法

標題

Markdown支持6種級別的標題,對應(yīng)html標簽 h1 ~ h6

h1

h2

h3

h4

h5
h6

以上標記效果如下:

h1

h2

h3

h4

h5
h6

除此之外宛琅,Markdown還支持另外一種形式的標題展示形式刻蟹,其類似于 Setext 標記語言的表現(xiàn)形式,使用下劃線進行文本大小的控制

這是一級標題
===
這是二級標題
---

使用這種方式處理標題僅有兩種表現(xiàn)形式嘿辟,即一級標題和二級標題舆瘪。遺憾的是片效,簡書并不支持這種語法。因此英古,我們用一張圖來展示效果:

這是一級標題

這是二級標題

這種處理方式在Github的一些開源工程上面比較常見淀衣,顯而易見的缺點是:文字大小控制級別有限。

段落及區(qū)塊引用

需要記住的是召调,Markdown其實就是一種易于編寫的普通文本膨桥,只不過加入了部分渲染文本的標簽而已。其最終依然會轉(zhuǎn)換為html標簽唠叛,因此使用Markdown分段非常簡單只嚣,前后至少保留一個空行即可。

而另外一個比較常見的需求就是艺沼,我們可能希望對某段文字進行強調(diào)處理册舞。Markdown提供了一個特殊符號>用于段首進行強調(diào),被強調(diào)的文字部分將會高亮顯示

> 這段文字將被高亮顯示...

以上標記顯示效果如下:

這段文字將被高亮顯示...

插入鏈接或圖片

Markdown針對鏈接和圖片的處理也比較簡單澳厢,可以使用下面的語法進行標記

[點擊跳轉(zhuǎn)至百度](http://www.baidu.com)
![圖片](https://upload-images.jianshu.io/upload_images/703764-605e3cc2ecb664f6.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
<305126491@qq.com>

以上標記顯示效果如下:
點擊跳轉(zhuǎn)至百度

圖片

305126491@qq.com

注: 引用圖片和鏈接的唯一區(qū)別就是在最前方添加一個感嘆號环础。

列表

Markdown支持有序列表和無序列表兩種形式:

  • 無序列表使用*或+或-標識
  • 有序列表使用數(shù)字加.標識囚似,例如:1.
* 黃瓜
* 玉米
* 茄子

+ 黃瓜
+ 玉米
+ 茄子

- 黃瓜
- 玉米
- 茄子

1. 黃瓜
2. 玉米
3. 茄子

以上標記顯示效果如下:

  • 黃瓜
  • 玉米
  • 茄子
  • 黃瓜
  • 玉米
  • 茄子
  • 黃瓜
  • 玉米
  • 茄子
  1. 黃瓜
  2. 玉米
  3. 茄子

注:這里比較有趣的地方是剩拢,對于有序列表,Markdown將只關(guān)注你的第一個項目的數(shù)字編號饶唤。例如:如果第一個項目編號是3徐伐,以此類推,第二個項目應(yīng)該是4募狂,最終將顯示為3办素、4、5祸穷。而如果你指定了第一個編號性穿,后面的編號指定錯誤也沒有關(guān)系,Markdown將只在乎你的第一個項目編號雷滚。

使用列表的一些注意事項

如果在單一列表項中包含了多個段落需曾,為了保證渲染正常,*與段落首字母之間必須保留四個空格

*    段落一

     小段一
*    段落二

     小段二

以上標記顯示效果如下:

  • 段落一

    小段一

  • 段落二

    小段二

另外祈远,如果在列表中加入了區(qū)塊引用呆万,區(qū)域引用標記符也需要縮進4個空格

* 段落一
    > 區(qū)塊標記一
* 段落二
    > 區(qū)塊標記二
  • 段落一

    區(qū)塊標記一

  • 段落二

    區(qū)塊標記二

注:記住一個原則,如果在和列表配合使用的時候出現(xiàn)了問題车份,就縮進一次谋减,四個空格或者一個制表符代表一次縮進。如果一次縮進沒有解決問題扫沼,那就兩次出爹。

分隔線

有時候庄吼,為了排版漂亮,可能會加入分隔線严就。Markdown加入分隔線非常簡單霸褒,使用下面任意一種形式都可以

***
---


產(chǎn)生分隔線的語法要求比較松,符號之間添加空格也可以盈蛮。

強調(diào)

有時候废菱,我們希望對某一部分文字進行強調(diào),使用*或_包裹即可抖誉。使用單一符號標記的效果是斜體殊轴,使用兩個符號標記的效果是加粗

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

**這里是加粗**
__這里是加粗__

***這里是斜體加粗***

~~這里是刪除~~

這里是斜體
這里是斜體

這里是加粗
這里是加粗

這里是斜體加粗

這里是刪除

高級用法

插入代碼塊

Markdown在IT圈子里面比較流行的一個重要原因是,它能夠輕松漂亮地插入代碼袒炉。

方法是旁理,使用反引號`進行包裹即可。如果是行內(nèi)代碼引用我磁,使用單個反引號進行包裹

這是一段var x = 3行內(nèi)代碼

如果插入一整段代碼孽文,需要至少使用兩個以上反引號進行包裹, 看效果:

fun (x: Int, y: Int): Int {
  return x + y
}

注:很多人不知道怎么輸入反引號夺艰。在英文模式下芋哭,找到鍵盤最左側(cè)esc鍵下面的第一個鍵點擊即可。

插入表格

表格是Markdown語法中比較復(fù)雜的一個郁副,其語法如下:

表頭|條目一|條目二
:---|:---:|---:
項目|項目一|項目二

以上標記顯示效果如下:

表頭 條目一 條目二
項目 項目一 項目二

注:三個短斜杠左右的冒號用于控制對齊方式减牺,只放置左邊冒號表示文字居左,只放置右邊冒號表示文字居右存谎,如果兩邊都放置冒號表示文字居中。

UML圖

渲染序列圖

小異常->大異常: 嘿稚失,老大, 看完博客評論了沒?
Note right of 大異常: 大異常愣了一下恰聘,說:
大異常-->小異常: 呀句各,差點忘了憨琳,馬上評論

sequence
小異常->大異常: 嘿,老大, 看完博客評論了沒?
Note right of 大異常: 大異常愣了一下篙螟,說:
大異常-->小異常: 呀菌湃,差點忘了遍略,馬上評論

渲染流程圖

st=>start: 開始
e=>end: 結(jié)束
com=>operation: 開始評論
cond=>condition: 確認評論?

st->com->cond
cond(yes)->e
cond(no)->com

其他

特殊符號處理

Markdown使用反斜杠\插入語法中用到的特殊符號纽绍。在Markdown中势似,主要有以下幾種特殊符號需要處理:

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

例如履因,如果你需要插入反斜杠,就連續(xù)輸入兩個反斜杠即可:\ => \ 站故。

注:在內(nèi)容中輸入以上特殊符號的時候一定要注意轉(zhuǎn)義西篓,否則將導(dǎo)致內(nèi)容顯示不全岂津,甚至排版混亂余掖。

如何給文字上色

使用Markdown的同學最郁悶的地方恐怕就是不能給文字添加顏色了盐欺。事實上仅醇,Markdown的最初目標就是為純寫作而生的析二。因此叶摄,它并沒有考慮文字顏色這一點。所以宵喂,單純使用Markdown設(shè)置文字顏色已經(jīng)做不到了锅棕。但你可以這樣做:

  1. 先用Markdown編輯完成
  2. 導(dǎo)出為html,在需要上色的部分手動添加標簽<font color='#ff0000'></font>保存即可顾瞻。

Markdown軟件推薦

如果你是一個Mac用戶荷荤,我推薦你使用開源的 MacDown

Macdown

如果你愿意花錢的話梅猿,一些收費產(chǎn)品其實更好袱蚓。例如:Byword几蜻,Ulysses梭稚,Typora等等都很不錯。

日常使用忱屑,我就用Macdown莺戒。寫書从铲,我就用Ulysses名段。

簡單總結(jié)

Markdown是一門比html更簡單的標記語言泣懊,其主要用于日常寫作馍刮。最終通過相應(yīng)的編輯器或者腳本轉(zhuǎn)換成html用于頁面渲染。如果你是一個作家脐彩,或者是一個程序員惠奸,Markdown對你來說是一門必備的技能佛南。掌握Markdown真的很簡單嵌言,如你所見摧茴,這篇文章使用了這么短的篇幅就已經(jīng)將Markdown的語法全部介紹完了苛白。
不過购裙,由于Markdown基礎(chǔ)語法的限制躏率,出現(xiàn)了一些針對Markdown語法的加強版本。它支持的語法特性更多蓬抄,但這不是我們這篇文章的討論范圍倡鲸。如果你希望快速掌握Markdown,很簡單逼争,動起來吧誓焦!

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末移层,一起剝皮案震驚了整個濱河市观话,隨后出現(xiàn)的幾起案子越平,更是在濱河造成了極大的恐慌秦叛,老刑警劉巖挣跋,帶你破解...
    沈念sama閱讀 222,464評論 6 517
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件舟肉,死亡現(xiàn)場離奇詭異度气,居然都是意外死亡磷籍,警方通過查閱死者的電腦和手機现柠,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 95,033評論 3 399
  • 文/潘曉璐 我一進店門比然,熙熙樓的掌柜王于貴愁眉苦臉地迎上來强法,“玉大人饮怯,你說我怎么就攤上這事蓖墅。” “怎么了教翩?”我有些...
    開封第一講書人閱讀 169,078評論 0 362
  • 文/不壞的土叔 我叫張陵,是天一觀的道長路捧。 經(jīng)常有香客問我杰扫,道長章姓,這世上最難降的妖魔是什么凡伊? 我笑而不...
    開封第一講書人閱讀 59,979評論 1 299
  • 正文 為了忘掉前任系忙,我火速辦了婚禮银还,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好孝扛,可當我...
    茶點故事閱讀 69,001評論 6 398
  • 文/花漫 我一把揭開白布冈欢。 她就那樣靜靜地躺著,像睡著了一般柠贤。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上邻吭,一...
    開封第一講書人閱讀 52,584評論 1 312
  • 那天,我揣著相機與錄音畸写,去河邊找鬼氓扛。 笑死采郎,一個胖子當著我的面吹牛蒜埋,可吹牛的內(nèi)容都是我干的整份。 我是一名探鬼主播皂林,決...
    沈念sama閱讀 41,085評論 3 422
  • 文/蒼蘭香墨 我猛地睜開眼础倍,長吁一口氣:“原來是場噩夢啊……” “哼沟启!你這毒婦竟也來了德迹?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 40,023評論 0 277
  • 序言:老撾萬榮一對情侶失蹤卸例,失蹤者是張志新(化名)和其女友劉穎筷转,沒想到半個月后呜舒,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 46,555評論 1 319
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 38,626評論 3 342
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發(fā)現(xiàn)自己被綠了廉侧。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片段誊。...
    茶點故事閱讀 40,769評論 1 353
  • 序言:一個原本活蹦亂跳的男人離奇死亡连舍,死狀恐怖索赏,靈堂內(nèi)的尸體忽然破棺而出潜腻,到底是詐尸還是另有隱情器仗,我是刑警寧澤精钮,帶...
    沈念sama閱讀 36,439評論 5 351
  • 正文 年R本政府宣布忽你,位于F島的核電站臂容,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏娜亿。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點故事閱讀 42,115評論 3 335
  • 文/蒙蒙 一吼畏、第九天 我趴在偏房一處隱蔽的房頂上張望泻蚊。 院中可真熱鬧性雄,春花似錦秒旋、人聲如沸迁筛。這莊子的主人今日做“春日...
    開封第一講書人閱讀 32,601評論 0 25
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽止邮。三九已至革骨,卻和暖如春良哲,著一層夾襖步出監(jiān)牢的瞬間筑凫,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 33,702評論 1 274
  • 我被黑心中介騙來泰國打工哩牍, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留膝昆,地道東北人荚孵。 一個月前我還...
    沈念sama閱讀 49,191評論 3 378
  • 正文 我出身青樓收叶,卻偏偏與公主長得像判没,于是被迫代替她去往敵國和親澄峰。 傳聞我的和親對象是個殘疾皇子患膛,可洞房花燭夜當晚...
    茶點故事閱讀 45,781評論 2 361

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

  • 前言 初學markdown,看了一些指南跃捣,第一次在簡書上用markdown做的一個總結(jié)疚漆,大部分為摘抄與精簡娶聘,主要是...
    Yolanda__WU閱讀 965評論 0 0
  • 一铆农、MarkDown是什么好東西狡耻? 1.認識MarkDown MarkDown 是一個 Web 上使用的文本到HT...
    球丁丁閱讀 1,557評論 1 15
  • atom編輯器的使用和markdown基本語法 atom介紹 atom是什么 Atom是github內(nèi)部的編輯軟件...
    Haoqian閱讀 35,601評論 3 39
  • #標題1##標題2###3級標題一級標題===一級標題========二級標題---<&?<####段落引用> T...
    oking閱讀 2,096評論 0 1
  • 1. 標題 Markdown 支持兩種標題的語法,類 Setext 和類 atx 形式爷绘。 類 Setext 形式是...
    Eva3288閱讀 414評論 0 0