Markdown使用

剛來簡書不久泡态,簡書的默認編輯器是富文本編輯器,考慮到對于代碼塊不友好冲粤,我打算換成Markdown編輯器淫茵,在此記錄下Markdown的使用溃论。

Markdown簡介

Markdown 是一種純文本、輕量級的標記語言痘昌,通過簡單的標記語法,以純文本的形式編寫炬转,以HTML格式發(fā)布辆苔。由 Aaron SwartzJohn Gruber 共同設計。

官方鏈接:
http://www.markdown.cn/

Markdown使用

目錄

標題
段落和換行
代碼區(qū)塊
區(qū)塊引用
列表
分割線
表格
字體
鏈接
代碼塊
圖片
強調
公式
腳注
自動郵箱鏈接

基本語法

標題

Markdown 支持兩種標題的語法扼劈,類 Setext 和類 atx 形式驻啤。這里指介紹類atx形式:

#這是h1
##這是h2
###這是h3
####這是h4
#####這是h5
######這是h6

效果如下:

這是h1

這是h2

這是h3

這是h4

這是h5
這是h6

段落和換行

段落:一個或多個連續(xù)的文本行,段落內會強迫換行(插入換行符)
空行:這一行包括一個以上的空行(空行定義:看起來是空的荐吵,比如骑冗,某一行包括一個空格和一個制表符,也是一個空行)

代碼區(qū)塊

在每行加上4個空格或者一個制表符(如同寫代碼一樣)

function a(){
}

注意:需要和普通段落之間存在空行先煎!

區(qū)塊引用

Markdown 標記區(qū)塊引用是使用類似 email 中用 (>) 的引用方式贼涩。
段落引用:

>這是個段落引用
>
>這是個段落引用

效果如下:

這是個段落引用

這是個段落引用

段落引用也可以只寫一個>

>This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.

嵌套引用:

 This is the first level of quoting.
>
> > This is nested blockquote.
>
> Back to the first level.

效果如下:

This is nested blockquote.

Back to the first level.

嵌套引用中可以使用其他的語法:

> ## 這是一個標題。
> 
> 1.   這是第一行列表項薯蝎。
> 2.   這是第二行列表項遥倦。
> 
> 給出一些例子代碼:
> 
>     return shell_exec("echo $input | $markdown_script");

效果如下:

這是一個標題。

  1. 這是第一行列表項占锯。
  2. 這是第二行列表項袒哥。

給出一些例子代碼:

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

列表

Markdown 支持有序列表和無序列表缩筛。
無序列表使用星號、加號或是減號作為列表標記:

*   Red
*   Green
*   Blue
  • Red
  • Green
  • Blue
+   Red
+   Green
+   Blue
  • Red
  • Green
  • Blue
-   Red
-   Green
-   Blue
  • Red
  • Green
  • Blue
    有序列表則使用數(shù)字接著一個英文句點:
1.  Bird
2.  McHale
3.  Parish
  1. Bird
  2. McHale
  3. Parish

在列表第二個標記之后使用的數(shù)字并不會影響輸出的 HTML 結果堡称,即你的數(shù)字可以不按順序瞎抛,但是編輯器會自動根據(jù)第一個輸出:

3.  Bird
1.  McHale
3.  Parish
  1. Bird
  2. McHale
  3. Parish

列表項目標記通常是放在最左邊,縮進最多 3 個空格却紧,項目標記后面則一定要接著至少一個空格或制表符桐臊。
列表項目可以包含多個段落,每個項目下的段落都必須縮進 4 個空格或是 1 個制表符:

1.  This is a list item with two paragraphs. Lorem ipsum dolor
    sit amet, consectetuer adipiscing elit. Aliquam hendrerit
    mi posuere lectus.

    Vestibulum enim wisi, viverra nec, fringilla in, laoreet
    vitae, risus. Donec sit amet nisl. Aliquam semper ipsum
    sit amet velit.

2.  Suspendisse id sem consectetuer libero luctus adipiscing.
  1. This is a list item with two paragraphs. Lorem ipsum dolor
    sit amet, consectetuer adipiscing elit. Aliquam hendrerit
    mi posuere lectus.

    Vestibulum enim wisi, viverra nec, fringilla in, laoreet
    vitae, risus. Donec sit amet nisl. Aliquam semper ipsum
    sit amet velit.

  2. Suspendisse id sem consectetuer libero luctus adipiscing.

嵌套列表:在下一級輸入一定空格即可啄寡。

*   Red 
     *   Red
     *   Green
     *   Blue     
*   Green
*   Blue
  • Red

    • Red
    • Green
    • Blue
  • Green

  • Blue

分割線

在一行中用三個以上的星號豪硅、減號、底線來建立一個分隔線挺物,行內不能有其他東西懒浮。你也可以在星號或是減號中間插入空格

* * *

***

*****

- - -

---------------------------------------





表格

語法:

表頭|表頭|表頭
---|:--:|---:
內容|內容|內容
內容|內容|內容
表頭 表頭 表頭
內容 內容 內容
內容 內容 內容

第二行分割表頭和內容。

  • 有一個就行识藤,為了對齊砚著,多加了幾個
    文字默認居左
  • 兩邊加:表示文字居中
  • 右邊加:表示文字居右
    注:原生的語法兩邊都要用 | 包起來。此處省略

字體

**這是加粗的文字**
*這是傾斜的文字*`
***這是斜體加粗的文字***
~~這是加刪除線的文字~~

這是加粗的文字
這是傾斜的文字`
這是斜體加粗的文字
這是加刪除線的文字

鏈接

Markdown 支持兩種形式的鏈接語法: 行內式和參考式兩種形式痴昧。

This is [an example](http://example.com/ "Title") inline link.

[This link](http://example.net/) has no title attribute.

This is an example inline link.

This link has no title attribute.

鏈接到主機:

See my [About](/about/) page for details.

See my About page for details.
參考式的鏈接是在鏈接文字的括號后面再接上另一個方括號稽穆,而在第二個方括號里面要填入用以辨識鏈接的標記:

This is [an example][id] reference-style link.

This is an example reference-style link.
接著,在文件的任意處赶撰,你可以把這個標記的鏈接內容定義出來:

[id]: http://example.com/  "Optional Title Here"

鏈接辨別標簽可以有字母舌镶、數(shù)字、空白和標點符號豪娜,但是并不區(qū)分大小寫餐胀。
鏈接語法可以幫助我們實現(xiàn)在MarkDown文檔中寫目錄樹,MarkDown會自動給每一個h1~h6標題生成一個錨瘤载,其id就是標題內容否灾,目錄樹中的每一項都是一個跳轉鏈接,點擊后就會跳轉到其對應的錨點(即標題所在位置)鸣奔∧迹可以有兩種寫法:

  1. 使用Markdown的語法來增加跳轉鏈接:“名稱”。
  2. 使用HTML語法來增加跳轉鏈接:“<a href=”#id”>名稱
[使用Markdown語法增加的跳轉到“目錄”的鏈接](#目錄) 

效果:
使用Markdown語法增加的跳轉到“目錄”的鏈接

或者這么寫:

<a href="#目錄">使用HTML語法增加的跳轉到“目錄”的鏈接 

效果:
<a href="#目錄">使用HTML語法增加的跳轉到“目錄”的鏈接

代碼塊

單行代碼:

`
單行代碼
`

單行代碼

代碼塊:點由一個變成三個“```”

代碼塊

圖片

語法

[圖片上傳失敗...(image-651641-1550589378470)]

圖片alt就是顯示在圖片下面的文字挎狸,相當于對圖片內容的解釋扣汪。
圖片title是圖片的標題,當鼠標移到圖片上時顯示的內容锨匆。title可加可不加
示例:

![程序貓](https://upload-images.jianshu.io/upload_images/15009210-
ca27889e0252066a.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
程序貓

強調

Markdown 使用星號(*)和底線(_)作為標記強調字詞的符號私痹,被 * 或 _ 包圍的字詞會被轉成用 <em> 標簽包圍,用兩個 * 或 _ 包起來的話,則會被轉成 <strong>

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

single asterisks

single underscores

double asterisks

double underscores
如果要在文字前后直接插入普通的星號或底線紊遵,你可以用反斜線:

\*this text is surrounded by literal asterisks\*

*this text is surrounded by literal asterisks*

公式

$$ x \href{why-equal.html}{=} y^2 + 1 $$
$ x = {-b \pm \sqrt{b^2-4ac} \over 2a}. $

x \href{why-equal.html}{=} y^2 + 1
x = {-b \pm \sqrt{b^2-4ac} \over 2a}.

腳注

Markdown[^1]
[^1]: Markdown是一種純文本標記語言        // 在文章最后面顯示腳注

Markdown[1]

自動郵箱鏈接

<xxx@outlook.com>

xxx@outlook.com


  1. Markdown是一種純文本標記語言 // 在文章最后面顯示腳注 ?

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯(lián)系作者
  • 序言:七十年代末账千,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子暗膜,更是在濱河造成了極大的恐慌匀奏,老刑警劉巖,帶你破解...
    沈念sama閱讀 217,509評論 6 504
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件学搜,死亡現(xiàn)場離奇詭異娃善,居然都是意外死亡,警方通過查閱死者的電腦和手機瑞佩,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,806評論 3 394
  • 文/潘曉璐 我一進店門聚磺,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人炬丸,你說我怎么就攤上這事瘫寝。” “怎么了稠炬?”我有些...
    開封第一講書人閱讀 163,875評論 0 354
  • 文/不壞的土叔 我叫張陵焕阿,是天一觀的道長。 經(jīng)常有香客問我首启,道長暮屡,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 58,441評論 1 293
  • 正文 為了忘掉前任毅桃,我火速辦了婚禮褒纲,結果婚禮上,老公的妹妹穿的比我還像新娘钥飞。我一直安慰自己莺掠,他們只是感情好,可當我...
    茶點故事閱讀 67,488評論 6 392
  • 文/花漫 我一把揭開白布代承。 她就那樣靜靜地躺著,像睡著了一般渐扮。 火紅的嫁衣襯著肌膚如雪论悴。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 51,365評論 1 302
  • 那天墓律,我揣著相機與錄音膀估,去河邊找鬼。 笑死耻讽,一個胖子當著我的面吹牛察纯,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 40,190評論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼饼记,長吁一口氣:“原來是場噩夢啊……” “哼香伴!你這毒婦竟也來了?” 一聲冷哼從身側響起具则,我...
    開封第一講書人閱讀 39,062評論 0 276
  • 序言:老撾萬榮一對情侶失蹤即纲,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后博肋,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體低斋,經(jīng)...
    沈念sama閱讀 45,500評論 1 314
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 37,706評論 3 335
  • 正文 我和宋清朗相戀三年匪凡,在試婚紗的時候發(fā)現(xiàn)自己被綠了膊畴。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 39,834評論 1 347
  • 序言:一個原本活蹦亂跳的男人離奇死亡病游,死狀恐怖唇跨,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情礁遵,我是刑警寧澤轻绞,帶...
    沈念sama閱讀 35,559評論 5 345
  • 正文 年R本政府宣布,位于F島的核電站佣耐,受9級特大地震影響政勃,放射性物質發(fā)生泄漏。R本人自食惡果不足惜兼砖,卻給世界環(huán)境...
    茶點故事閱讀 41,167評論 3 328
  • 文/蒙蒙 一奸远、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧讽挟,春花似錦懒叛、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,779評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至眼姐,卻和暖如春诅迷,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背众旗。 一陣腳步聲響...
    開封第一講書人閱讀 32,912評論 1 269
  • 我被黑心中介騙來泰國打工罢杉, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人贡歧。 一個月前我還...
    沈念sama閱讀 47,958評論 2 370
  • 正文 我出身青樓滩租,卻偏偏與公主長得像赋秀,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子律想,可洞房花燭夜當晚...
    茶點故事閱讀 44,779評論 2 354

推薦閱讀更多精彩內容

  • Markdown概述 宗旨 Markdown 的目標是實現(xiàn)「易讀易寫」猎莲。Markdown 的特點就是,讓寫作變得更...
    心疼你萌萌噠閱讀 7,716評論 1 24
  • 1. 斜體和粗體 代碼: 顯示效果: 這是一段斜體 這是一段粗體 這是一段加粗斜體 這是一段刪除線 2. 分級標題...
    泊牧閱讀 2,342評論 0 2
  • 勞動者在從事職業(yè)活動或者與職業(yè)活動有關的活動時所遭受的不良因素的傷害稱之為工傷郭脂,我們都很容易就想到在工作場所發(fā)生的...
    悟三分閱讀 4,855評論 1 107
  • 第155章:拉兩美女入會所 韓梅和伊寒秋二人難得有時間在家做飯吃,所以一口氣買了五斤餃子皮澈歉,在菜市場絞了肉餡展鸡,此時...
    墨棠子閱讀 1,431評論 16 38
  • 入手寫文時我猛一驚涡尘,連姐姐都三十三歲了忍弛。 但仔細一想,可不是嘛考抄,連我這個妹妹都三十一了细疚。只是我婚齡四年,姐姐連結婚...
    饞嘴貓呀閱讀 673評論 0 4