【系統(tǒng)學(xué)習(xí)Markdown1】基礎(chǔ)語(yǔ)法入門

我的更多相關(guān)文章:

  • Markdown 是一種輕量級(jí)且易使用的標(biāo)記語(yǔ)言型凳,通過(guò)對(duì)標(biāo)題心俗、正文、加粗回官、鏈接等主要文本格式的預(yù)設(shè)編碼曹宴,幫用戶在寫作中有效避免頻繁的格式調(diào)整,獲得更加流暢沉浸的寫作體驗(yàn)歉提。

  • Markdown具有一系列衍生版本笛坦,用于擴(kuò)展Markdown的功能(如表格区转、腳注、內(nèi)嵌HTML等等)版扩,這些功能原初的Markdown尚不具備废离,它們能讓Markdown轉(zhuǎn)換成更多的格式

本文內(nèi)容整合了:

目錄 ([TOC])

[TOC] (emmmm……貌似簡(jiǎn)書不支持)


目錄效果

標(biāo)題(#### 一蜻韭、標(biāo)題)

<u>下劃線</u>(<u>下劃線</u>)

刪除線(~刪除線~)

***、---宴偿、___ 分隔線

斜體(*斜體*)

直接回車不能換行,
可以在上一行文本后面補(bǔ)兩個(gè)空格湘捎,
這樣下一行的文本就換行了。  

或者就是在兩行文本直接加一個(gè)空行窄刘。

也能實(shí)現(xiàn)換行效果,不過(guò)這個(gè)行間距有點(diǎn)大舷胜。  

圖片(**加粗**)

格式:![alt](URL title)

alt和title即對(duì)應(yīng)HTML中的alt和title屬性(都可省略):

  • alt表示圖片顯示失敗時(shí)的替換文本
  • title表示鼠標(biāo)懸停在圖片時(shí)的顯示文本(注意這里要加引號(hào))

URL即圖片的url地址娩践,如果引用本倉(cāng)庫(kù)中的圖片,直接使用相對(duì)路徑就可了烹骨,如果引用其他github倉(cāng)庫(kù)中的圖片要注意格式翻伺,即:倉(cāng)庫(kù)地址/raw/分支名/圖片路徑,如:

https://github.com/guodongxiaren/ImageCache/raw/master/Logo/foryou.gif
圖片

注意例2的寫法使用了URL標(biāo)識(shí)符的形式沮焕,在鏈接一節(jié)有介紹吨岭。

在文末有foryou的定義:
[foryou]:https://github.com/guodongxiaren/ImageCache/raw/master/Logo/foryou.gif
[foryou]:https://github.com/guodongxiaren/ImageCache/raw/master/Logo/foryou.gif

另外,針對(duì)插入的本地圖片可以控制圖片大小峦树,在拖拽辣辫、拷貝或者點(diǎn)擊插入本地圖片之后,直接在圖片名稱后面(無(wú)需空格)添加以下語(yǔ)法均可以按照以下要求控制圖片大锌:(只有印象筆記才能實(shí)現(xiàn))

@w=300
@h=150
@w=200h=100
@h=100w=200
image

@w=300

鏈接

  • 語(yǔ)法1:[印象筆記官網(wǎng)](https://www.yinxiang.com/) 印象筆記官網(wǎng)
  • 語(yǔ)法2:[我的知乎][zhihu] [我的知乎][zhihu] # 在簡(jiǎn)書中不能實(shí)現(xiàn)

語(yǔ)法2由兩部分組成:

  • 第一部分使用兩個(gè)中括號(hào)急灭,[ ]里的標(biāo)識(shí)符(本例中zhihu),可以是數(shù)字谷遂,字母等的組合葬馋,標(biāo)識(shí)符上下對(duì)應(yīng)就行了(姑且稱之為URL標(biāo)識(shí)符)
  • 第二部分標(biāo)記實(shí)際URL。

使用URL標(biāo)識(shí)符能達(dá)到復(fù)用的目的肾扰,一般把全文所有的URL標(biāo)識(shí)符統(tǒng)一放在文章末尾畴嘶,這樣看起來(lái)比較干凈。

[zhihu]:https://github.com/guodongxiaren/README#%E6%A8%AA%E7%BA%BF
[zhihu]:https://github.com/guodongxiaren/README#%E6%A8%AA%E7%BA%BF
URL語(yǔ)法:[標(biāo)簽名](鏈接地址)

圖片鏈接 (重點(diǎn)難點(diǎn))

給圖片加鏈接的本質(zhì)是混合圖片顯示語(yǔ)法和普通的鏈接語(yǔ)法集晚。普通的鏈接中[ ]內(nèi)部是鏈接要顯示的文本窗悯,而圖片鏈接[ ]里面則是要顯示的圖片。直接混合兩種語(yǔ)法當(dāng)然可以甩恼,但是十分啰嗦蟀瞧,為此我們可以使用URL標(biāo)識(shí)符的形式沉颂。


例子

因?yàn)閳D片本身和鏈接本身都支持URL標(biāo)識(shí)符的形式,所以圖片鏈接也可以很簡(jiǎn)潔(見例3)悦污。
注意铸屉,此時(shí)鼠標(biāo)懸停時(shí)顯示的文字是圖片的title,而非鏈接本身的title了切端。

錨點(diǎn)

其實(shí)呢彻坛,每一個(gè)標(biāo)題都是一個(gè)錨點(diǎn),和HTML的錨點(diǎn)(#)類似踏枣,比如我們:
[ 回到標(biāo)題 ](#標(biāo)題) 回到標(biāo)題 (不知道為什么實(shí)現(xiàn)不了)
不過(guò)要注意昌屉,標(biāo)題中的英文字母都被轉(zhuǎn)化為小寫字母了。
以前GitHub對(duì)中文支持的不好茵瀑,所以中文標(biāo)題不能正確識(shí)別為錨點(diǎn)间驮,但是現(xiàn)在已經(jīng)沒(méi)問(wèn)題啦!

表格

| 帳戶類型 | 免費(fèi)帳戶 | 標(biāo)準(zhǔn)帳戶 | 高級(jí)帳戶 |
| --- | --- | --- | --- |
| 帳戶流量 | 60M | 1GB | 10GB |
| 設(shè)備數(shù)目 | 2臺(tái) | 無(wú)限制 | 無(wú)限制 |
| 當(dāng)前價(jià)格 | 免費(fèi) | ¥8.17/月 | ¥12.33/月|
帳戶類型 免費(fèi)帳戶 標(biāo)準(zhǔn)帳戶 高級(jí)帳戶
帳戶流量 60M 1GB 10GB
設(shè)備數(shù)目 2臺(tái) 無(wú)限制 無(wú)限制
當(dāng)前價(jià)格 免費(fèi) ¥8.17/月 ¥12.33/月
對(duì)齊

貌似現(xiàn)在印象筆記不能實(shí)現(xiàn)马昨,但有道云筆記可以實(shí)現(xiàn)

表格文本對(duì)齊

混合其他語(yǔ)法
  • 使用普通文本的刪除線竞帽,斜體等效果
  • 表格中嵌入圖片(鏈接)

表情

目前印象筆記貌似不支持
Github的Markdown語(yǔ)法支持添加emoji表情,輸入不同的符號(hào)碼(兩個(gè)冒號(hào)包圍的字符)可以顯示出不同的表情鸿捧。比如:blush:屹篓,可以顯示??。

具體每一個(gè)表情的符號(hào)碼匙奴,可以查詢GitHub的官方網(wǎng)頁(yè)http://www.emoji-cheat-sheet.com堆巧。
可以直接在此查看emoji

列表

多級(jí)無(wú)序列表
  • aaa
    • bbb
  • ccc
    • ddd
      • eee
- aaa    
    - bbb
* ccc
    * ddd
        * eee
多級(jí)有序列表

面向?qū)ο蟮娜齻€(gè)基本特征:

  1. 封裝
    1.1 ……
    1.1.1 ……
  2. 繼承
  3. 多態(tài)
面向?qū)ο蟮娜齻€(gè)基本特征:

1. 封裝
    1.1 ……
        1.1.1 ……
2. 繼承
3. 多態(tài)

(PS:這個(gè)跟Githup有些區(qū)別)

復(fù)選框列表

復(fù)選框列表
- [x] 需求分析
- [x] 系統(tǒng)設(shè)計(jì)
- [x] 詳細(xì)設(shè)計(jì)
* [x] 編碼
* [ ] 測(cè)試
* [ ] 交付

您可以使用這個(gè)功能來(lái)標(biāo)注某個(gè)項(xiàng)目各項(xiàng)任務(wù)的完成情況

Tip:

在GitHub的issue中使用該語(yǔ)法是可以實(shí)時(shí)點(diǎn)擊復(fù)選框來(lái)勾選或解除勾選的,而無(wú)需修改issue原文泼菌。

文字高亮

tag (`tag`)

語(yǔ)句塊

語(yǔ)法1 (文本第一行需要空行)

語(yǔ)句塊1      #在一行開頭加入1個(gè)Tab或者4個(gè)空格谍肤。
歡迎到訪
很高興見到您
祝您,早上好灶轰,中午好谣沸,下午好,晚安 

語(yǔ)法2

語(yǔ)句塊2     #使用一對(duì)各三個(gè)的反引號(hào):

多級(jí)塊引用

數(shù)據(jù)結(jié)構(gòu)

二叉樹

平衡二叉樹

滿二叉樹

> 數(shù)據(jù)結(jié)構(gòu)
>> 樹
>>> 二叉樹
>>>> 平衡二叉樹
>>>>> 滿二叉樹

代碼高亮

在三個(gè)反引號(hào)后面加上編程語(yǔ)言的名字笋颤,另起一行開始寫代碼乳附,最后一行再加上三個(gè)反引號(hào)。

```python
……
```

#!/usr/bin/python
import re



line = "Cats are smarter than dogs"



matchObj = re.match( r'(.*) are (.*?) .*', line, re.M|re.I)



if matchObj:
    print "matchObj.group() : ", matchObj.group()
    print "matchObj.group(1) : ", matchObj.group(1)
    print "matchObj.group(2) : ", matchObj.group(2)
else:
    print "No match!!"

diff語(yǔ)法

版本控制的系統(tǒng)中都少不了diff的功能伴澄,即展示一個(gè)文件內(nèi)容的增加與刪除赋除。 GFM中可以顯示的展示diff效果。使用綠色表示新增非凌,紅色表示刪除举农。

其語(yǔ)法與代碼高亮類似,只是在三個(gè)反引號(hào)后面寫diff敞嗡, 并且其內(nèi)容中颁糟,以 + 開頭表示新增航背,- 開頭表示刪除。

親測(cè):目前印象筆記并不支持棱貌,有道云筆記和簡(jiǎn)書支持玖媚,簡(jiǎn)書渲染效果有些不同。

有道云筆記的正常效果

簡(jiǎn)書diff語(yǔ)法渲染的效果:

+ aaa
- bbb

文本縮進(jìn):

&emsp;&emsp;

不建議使用Markdown的幾種情況

  1. 項(xiàng)目屬性的筆記:所謂項(xiàng)目屬性婚脱,就是創(chuàng)建筆記的目的是為了完成某個(gè)工作和生活的專項(xiàng)任務(wù)

    • 完成新作品的靈感記錄今魔、 活動(dòng)策劃等
    • 因?yàn)轫?xiàng)目筆記往往會(huì)涉及到非常多附件、圖片障贸、排期错森、任務(wù)列表等內(nèi)容
  2. 對(duì)文本格式有更多需求的筆記

    • 可能會(huì)需要各種不同格式去區(qū)分不同的內(nèi)容,比如不同顏色代表概念篮洁、重點(diǎn)涩维、難點(diǎn)、背誦點(diǎn)等嘀粱,普通筆記的體驗(yàn)會(huì)更出色激挪。
  3. 印象筆記中其他幾點(diǎn)臨時(shí)不支持的內(nèi)容

    • 移動(dòng)端和網(wǎng)頁(yè)端不支持對(duì) Markdown 筆記的編輯
    • 暫止不支持筆記內(nèi)部鏈接,不支持添加印象筆記內(nèi)鏈

看完本文后的進(jìn)階路徑

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末宛篇,一起剝皮案震驚了整個(gè)濱河市娃磺,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌叫倍,老刑警劉巖偷卧,帶你破解...
    沈念sama閱讀 210,914評(píng)論 6 490
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場(chǎng)離奇詭異吆倦,居然都是意外死亡听诸,警方通過(guò)查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 89,935評(píng)論 2 383
  • 文/潘曉璐 我一進(jìn)店門蚕泽,熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái)晌梨,“玉大人,你說(shuō)我怎么就攤上這事须妻∽序颍” “怎么了?”我有些...
    開封第一講書人閱讀 156,531評(píng)論 0 345
  • 文/不壞的土叔 我叫張陵荒吏,是天一觀的道長(zhǎng)敛惊。 經(jīng)常有香客問(wèn)我,道長(zhǎng)绰更,這世上最難降的妖魔是什么瞧挤? 我笑而不...
    開封第一講書人閱讀 56,309評(píng)論 1 282
  • 正文 為了忘掉前任锡宋,我火速辦了婚禮,結(jié)果婚禮上特恬,老公的妹妹穿的比我還像新娘执俩。我一直安慰自己,他們只是感情好鸵鸥,可當(dāng)我...
    茶點(diǎn)故事閱讀 65,381評(píng)論 5 384
  • 文/花漫 我一把揭開白布奠滑。 她就那樣靜靜地躺著,像睡著了一般妒穴。 火紅的嫁衣襯著肌膚如雪宋税。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 49,730評(píng)論 1 289
  • 那天讼油,我揣著相機(jī)與錄音杰赛,去河邊找鬼。 笑死矮台,一個(gè)胖子當(dāng)著我的面吹牛乏屯,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播瘦赫,決...
    沈念sama閱讀 38,882評(píng)論 3 404
  • 文/蒼蘭香墨 我猛地睜開眼辰晕,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼!你這毒婦竟也來(lái)了确虱?” 一聲冷哼從身側(cè)響起含友,我...
    開封第一講書人閱讀 37,643評(píng)論 0 266
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤,失蹤者是張志新(化名)和其女友劉穎校辩,沒(méi)想到半個(gè)月后窘问,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 44,095評(píng)論 1 303
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡宜咒,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 36,448評(píng)論 2 325
  • 正文 我和宋清朗相戀三年惠赫,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片故黑。...
    茶點(diǎn)故事閱讀 38,566評(píng)論 1 339
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡儿咱,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出倍阐,到底是詐尸還是另有隱情概疆,我是刑警寧澤,帶...
    沈念sama閱讀 34,253評(píng)論 4 328
  • 正文 年R本政府宣布峰搪,位于F島的核電站岔冀,受9級(jí)特大地震影響,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜使套,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 39,829評(píng)論 3 312
  • 文/蒙蒙 一罐呼、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧侦高,春花似錦嫉柴、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,715評(píng)論 0 21
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)。三九已至瞧壮,卻和暖如春登馒,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背咆槽。 一陣腳步聲響...
    開封第一講書人閱讀 31,945評(píng)論 1 264
  • 我被黑心中介騙來(lái)泰國(guó)打工陈轿, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人秦忿。 一個(gè)月前我還...
    沈念sama閱讀 46,248評(píng)論 2 360
  • 正文 我出身青樓麦射,卻偏偏與公主長(zhǎng)得像,于是被迫代替她去往敵國(guó)和親灯谣。 傳聞我的和親對(duì)象是個(gè)殘疾皇子潜秋,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 43,440評(píng)論 2 348

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

  • markdown github markdown語(yǔ)法 markdown引擎 學(xué)習(xí)markdown 文檔說(shuō)明 本文用...
    LucasLight閱讀 18,993評(píng)論 0 15
  • README =========================== 該文件用來(lái)測(cè)試和展示書寫README的各種m...
    樓下吃我一記蕉閱讀 466評(píng)論 0 0
  • 輕點(diǎn)一抹的綠色 讓春光乍泄 枝頭暴露的嫩芽 點(diǎn)綴著略微蕭瑟 梧桐樹的枯葉 還吊在枝上 搖搖欲墜不愿歸家 風(fēng)卷動(dòng)思念...
    落子秋閱讀 415評(píng)論 1 6
  • 看著日出日落半等,呼吸著自由的空氣,踏踏實(shí)實(shí)的過(guò)日子呐萨,突然覺得很舒暢。 不較真 不嫉妒 接受平凡的自己莽囤,過(guò)著普通卻很有...
    曦淅公主閱讀 477評(píng)論 0 0
  • 都挺好的朽缎,我們只是在看手機(jī)惨远。 很多時(shí)候我們都挺好的,因?yàn)榇藭r(shí)我們已經(jīng)下班回家吃完飯坐在電視機(jī)前陪家人聊天话肖。 而此時(shí)...
    筆中天閱讀 446評(píng)論 0 2