markdown中文語法說明

概述

宗旨

<p>Markdown 的目標是實現(xiàn)【易讀易寫】盘榨。</p>
<p>可讀性解总,無論如何都是最重要的宇葱。一份使用Markdown 格式撰寫的文件應該可以直接以純文本發(fā)布筷黔,并且看起來不會是由很多標簽或是格式命令組成往史。Markdown 語法受到一些既有 text-HTML 格式的影響,而最大靈感其實是純文本電子郵件格式的影響佛舱。</p>
總之椎例,Markdown 的語法全由一些符號組成,這些符號經(jīng)過精挑細選请祖,其作用一目了然订歪。比如:在文字兩旁加上星號(*),看起來就是強調肆捕。Markdown 的列表看起來刷晋,嗯,就是列表慎陵。Markdown 的區(qū)塊引用看起來就像是引用一段文字眼虱。

兼容HTML

<p>Markdown 語法的目標是:成為一種適用于網(wǎng)絡的<em>書寫</em>語音。</p>
<p>Markdown 不是要取代 HTML席纽,甚至也不是要和它接近捏悬。它的語法種類很少,只占 HTML 標記的一小部分润梯。Markdown 的構想<em>不是</em>要使得 HTML 更易書寫过牙。Markdown的理念是,能讓文檔更容易讀仆救、寫和隨意改抒和。HTML 是一種<em>發(fā)布</em>的格式矫渔,Markdown 是一種<em>書寫</em>的格式彤蔽。就這樣,Markdown 的格式語法只覆蓋純文本可以涵蓋的范圍庙洼。</p>
<p>不在 Markdown 涵蓋范圍之內的標簽顿痪,都可以直接在文檔里面用 HTML 撰寫。不需要額外標注這是 HTML 或是 Markdown 油够;只要直接加標簽就可以了蚁袭。</p>
<p>要制約的只有一些 HTML 區(qū)塊元素—比如 '<div>'、 <code><table></code> 等標簽,必須要在前后加上空行與其他內容區(qū)隔開石咬,還要求它們的開始標簽與結尾標簽不能用制表符或空格來縮進揩悄。</p>
<p>例子如下,在 Markdown 文件里加上一段 HTML 表格:</p>
<pre><code>這是一個普通段落鬼悠。
<table>
<tr>
<td>Foo</td>
</tr>
</table>
這是另一個普通段落删性。
</code></pre>
<p>請注意亏娜,在 HTML 區(qū)塊標簽間的 Markdown 格式語法將不會被處理。比如蹬挺,你在 HTML 區(qū)塊內使用 Markdown 樣式的強調會沒有效果维贺。</p>
HTML 的區(qū)段(行內)標簽如<code><span></code>、<code><del></code> 可以在Markdown 的段落巴帮、列表或是標題里隨意使用溯泣。依照個人習慣,甚至直接可以用 HTML 標簽來格式化榕茧。舉例說明垃沦,如果比較喜歡 HTML 的<code><<img>></code>標簽,可以直接使用這些標簽雪猪,而不用 Markdown 提高的鏈接或是圖像標簽語法栏尚。</p>
<p>和處在 HTML 區(qū)塊標簽間不同,Markdown 語法在 HTML 區(qū)段標簽間是有效的只恨。</p>

特殊字符自動轉換

在 HTML 文件中译仗,有兩個字符需要特別處理:<code><</code>、<code>&</code> 官觅。<code><</code> 用于起始標簽纵菌,<code>&</code> 用于標記 HTML 實體。如果你只是要使用這個符號休涤,你必須要使用實體的形式咱圆,比如,像是 < 功氨、& 序苏。

<code>&</code> 字符尤其讓網(wǎng)絡文檔編寫者受折磨,如果你要打 AT&T, 你必須要寫成 ‘AT&T’ 捷凄。而網(wǎng)址中的 & 也要轉換忱详。如果要鏈接到:
http://images.google.com/images?num=30&q=larry+bird
你必須把網(wǎng)址轉換寫為
http://images.google.com/images?num=30&q=larry+bird
才能放到鏈接標簽的 href 屬性里。不用說也知道這很容易忽略跺涤。這也可能是 HTML 標準檢驗所檢查到的錯誤中匈睁,數(shù)量最多的。

Markdown 讓你可以自然地書寫字符桶错,需要轉換的由它來處理就好了航唆。如果你使用的 & 字符是 HTML 字符實體的一部分,它會保留原狀院刁,否則它會轉換成 &糯钙。

所以,如果要在文檔中插入一個版權符號?,你可以這樣寫:
?
Markdown 會保留它不動任岸。

需要注意的是鸳玩, code 范圍內,不論是行內還是區(qū)塊演闭, <& 兩個符號都一定會被轉換成 HTML 實體不跟,這項特性讓你可以用 Markdown 寫 HTML code 。

區(qū)塊元素

段落和換行

<p>一個 Markdown 段落是由一個或多個連續(xù)的文本行組成米碰,它的前后要有一個以上的空行(空行的定義是顯示上看起來像是空的窝革,便會被視為空行。比如吕座,若某一行只含空格和 Tab虐译, 則該行業(yè)將視為空行)。普通段落不該用空格或 Tab 來縮進吴趴。</p>

「一個以上相連接的行句組成」這句話其實暗示了 Markdown 允許段落內的強迫斷行漆诽,這個特性和其他大部分的 text-to-HTML 格式不一樣(包括 MovableType 的「Convert Line Breaks」選項),其它的格式會把每個斷行都轉成 <br /> 標簽锣枝。

標題

區(qū)塊引用

Markdown 標記區(qū)塊引用是使用類似 email 中用 > 的引用方式厢拭。

This is a blockquote with two paragraphs.

Markdown也允許你偷懶只在整個段落的第一行最前面加上> :

區(qū)塊引用可以嵌套,只要根據(jù)層次加上不同數(shù)量的 > :

This is the first level of quoting.

This is nested blackquote.

Back to the first level.

引用的區(qū)塊內也可以使用其他的 Markdown 語法撇叁,包括標題供鸠、列表、代碼區(qū)塊等:

This is a header.

  1. This is the first list item.
    
  2. This is the second list item.
    

Here's some example code:

return shell_exec("echo $input | $markdown_script");

清單

Markdown 支持有序清單和無序清單陨闹。

無序清單使用星號楞捂、加號或減號作為清單標記。
* red
* green
* purple

等同于:

  • red
  • green
  • purple

也等同于

  • red
  • green
  • purple

有序清單則使用數(shù)字接著一個英文句點:

  1. bird
  2. McHale
  3. Parish

要讓清單看起來更漂亮趋厉,你可以把內容用固定的縮排整理好:

  • 《 Fantastic animals 》is an impressive movie i have  
      watched in this year.
    
  •  《神奇動物在哪里》這部電影讓我印象深刻寨闹,里面的 
      魔法生物各有各的特點。
    

如果清單項目用空行隔開君账,Markdown 會把項目內容在輸出時用<p>標簽包起來繁堡,舉例來說:

  • Bird

  • Magic

會被轉換為:

<ul>
<li>Bird</li>
<li><p>Magic</p></li>
</ul>

項目清單很有可能會不小心產(chǎn)生,如:
1986.It is a great season.
換句話說杈绸,在行首出現(xiàn) 數(shù)字-句號-空白 帖蔓,要避免這樣的情況矮瘟,可以在數(shù)字后加斜線:
1986/. It is a great season.

程序區(qū)塊

和程序相關的寫作或者標記語言原始代碼通常會有已經(jīng)排版好的程序區(qū)塊瞳脓,通常這些區(qū)塊我們并不希望它以一般段落文件的形式去排版,而是原來的樣子澈侠。Markdown 會用<pre><code>把程序區(qū)塊包起來劫侧。

要在 Markdown 中建立程序區(qū)塊很簡單,只要縮排4個空白或是1個tab即可。

分隔線

用三個以上的星號烧栋、減號写妥、底線來建立一個分隔線,行內不能有其他東西审姓。


-----



區(qū)內要素

鏈接

Markdown 支持行內參考兩種形式的鏈接語法珍特。不管是哪一種,鏈接的文字都是用[方括號]來標記魔吐。

要建立一個行內形式的鏈接扎筒,只需要在方括號的后面馬上接著括號并插入網(wǎng)頁鏈接即可,如果你還想要加上鏈接的 title 文字酬姆,只要在網(wǎng)址后面嗜桌,用雙引號把 title 文字包起來即可。

參與形式的鏈接使用另外一個方括號接在鏈接文字的括號后面辞色,而在第二個方括號后面要填入用以辨別鏈接的標簽骨宠。接著,在文章的任意處相满,你可以把這個標簽的鏈接內容定義出來层亿。
鏈接定義的形式為:

  • 方括號,里面輸入鏈接的辨識用標簽
  • 接著一個冒號
  • 接著一個以上的空白或tab
  • 接著鏈接的網(wǎng)址
  • 選擇性地接著title內容立美,可以用單引號棕所、雙引號或者括弧包著

你也可以把title屬性放到下一行,也可以加一些縮排悯辙,網(wǎng)址太長的話琳省,這樣比較美觀。
舉例:
I get 10 traffics from Google than from [Yahoo] [2] or [MSN] [3].
1: http://google.com "Google"
[2]: http://search.yahoo.com "Yahoo"
[3]: http://search.msn.com "MSN"

強調

Markdown 使用星號()和底線(_)作為標記強調字詞的符號躲撰,被 * 或 _ 包圍的字詞會被轉換成用<em>標簽包圍针贬,用兩個 或 _ 包圍的字詞會被轉換成<strong>.

但是如果*_兩邊都有空白的話拢蛋,他們就只會看被當做普通的符號桦他。

如果要在文字前后直接插入普通的星號或底線,可以用反斜線:
\這段文字沒有被強調\

圖片

圖片與鏈接的插入方法相似谆棱,只是在鏈接的語法前加上了快压!

注:本文內容引用自 Markdown語法說明繁體版, 練習Markdown語法所用垃瞧。

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯(lián)系作者
  • 序言:七十年代末蔫劣,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子个从,更是在濱河造成了極大的恐慌脉幢,老刑警劉巖歪沃,帶你破解...
    沈念sama閱讀 206,602評論 6 481
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異嫌松,居然都是意外死亡沪曙,警方通過查閱死者的電腦和手機,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,442評論 2 382
  • 文/潘曉璐 我一進店門萎羔,熙熙樓的掌柜王于貴愁眉苦臉地迎上來液走,“玉大人,你說我怎么就攤上這事贾陷∮模” “怎么了?”我有些...
    開封第一講書人閱讀 152,878評論 0 344
  • 文/不壞的土叔 我叫張陵昵宇,是天一觀的道長磅崭。 經(jīng)常有香客問我,道長瓦哎,這世上最難降的妖魔是什么砸喻? 我笑而不...
    開封第一講書人閱讀 55,306評論 1 279
  • 正文 為了忘掉前任敞映,我火速辦了婚禮吃挑,結果婚禮上,老公的妹妹穿的比我還像新娘诀蓉。我一直安慰自己犯助,他們只是感情好癣漆,可當我...
    茶點故事閱讀 64,330評論 5 373
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著剂买,像睡著了一般惠爽。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上瞬哼,一...
    開封第一講書人閱讀 49,071評論 1 285
  • 那天婚肆,我揣著相機與錄音,去河邊找鬼坐慰。 笑死较性,一個胖子當著我的面吹牛,可吹牛的內容都是我干的结胀。 我是一名探鬼主播赞咙,決...
    沈念sama閱讀 38,382評論 3 400
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼糟港!你這毒婦竟也來了攀操?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 37,006評論 0 259
  • 序言:老撾萬榮一對情侶失蹤着逐,失蹤者是張志新(化名)和其女友劉穎崔赌,沒想到半個月后,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體耸别,經(jīng)...
    沈念sama閱讀 43,512評論 1 300
  • 正文 獨居荒郊野嶺守林人離奇死亡健芭,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 35,965評論 2 325
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發(fā)現(xiàn)自己被綠了秀姐。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片慈迈。...
    茶點故事閱讀 38,094評論 1 333
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖省有,靈堂內的尸體忽然破棺而出痒留,到底是詐尸還是另有隱情,我是刑警寧澤蠢沿,帶...
    沈念sama閱讀 33,732評論 4 323
  • 正文 年R本政府宣布伸头,位于F島的核電站,受9級特大地震影響舷蟀,放射性物質發(fā)生泄漏恤磷。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點故事閱讀 39,283評論 3 307
  • 文/蒙蒙 一野宜、第九天 我趴在偏房一處隱蔽的房頂上張望扫步。 院中可真熱鬧,春花似錦匈子、人聲如沸河胎。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,286評論 0 19
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽游岳。三九已至,卻和暖如春其徙,著一層夾襖步出監(jiān)牢的瞬間吭历,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 31,512評論 1 262
  • 我被黑心中介騙來泰國打工擂橘, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留晌区,地道東北人。 一個月前我還...
    沈念sama閱讀 45,536評論 2 354
  • 正文 我出身青樓通贞,卻偏偏與公主長得像朗若,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子昌罩,可洞房花燭夜當晚...
    茶點故事閱讀 42,828評論 2 345

推薦閱讀更多精彩內容