Markdown的一些心得(適合初學(xué)者)

孰能生巧

寫在前面

簡(jiǎn)潔,是普羅大眾所追求的一種精神八孝。當(dāng)我在編寫文檔的時(shí)候董朝,當(dāng)時(shí)還是用Windows系統(tǒng),用Word編寫文字覺(jué)得很不簡(jiǎn)潔干跛。而現(xiàn)在Markdown的出現(xiàn)給很多作者一個(gè)非常棒的寫作工具子姜。之前想裝逼去學(xué) Latex ,發(fā)現(xiàn)不如Markdown簡(jiǎn)單易懂楼入,其中需要很多命令和代碼來(lái)堆疊哥捕,而且對(duì)于 正常寫作的人 來(lái)說(shuō)不是一個(gè)非常好的選擇瓢姻。而Markdown則是一個(gè)很容易上手的工具脱茉。

后來(lái)看了一下網(wǎng)上的(基本就是簡(jiǎn)書吧),教程都是很專業(yè)纤掸,很系統(tǒng)阐肤,但是覺(jué)得不太適合初學(xué)者凫佛。里面羅列了很多知識(shí)包括HTML的代碼實(shí)現(xiàn)和Markdown的工作原理。我是一個(gè)程序猿嘛孕惜,我知道初學(xué)者一般都想: 你說(shuō)這么多愧薛,都不敲代碼,說(shuō)個(gè)鬼啊衫画。所以我在這里我不想講這些毫炉,我想通過(guò)舉例子來(lái)讓你了解Markdown的基本語(yǔ)法。而這些語(yǔ)法保證可以夠你完成 99.9% 的工作削罩。

這里有人問(wèn)了怎么在簡(jiǎn)書上寫Markdown碘箍,簡(jiǎn)書默認(rèn)是使用“富文本”形式的編輯器,說(shuō)白了就是非Markdown嘛鲸郊。設(shè)置到Markdown編輯器再將你寫好的內(nèi)容復(fù)制到上面去就好了丰榴。參考這里設(shè)置你的簡(jiǎn)書為Markdown編輯器

目錄

  • 寫Markdown的工具
  • 基本知識(shí)
  • 實(shí)踐運(yùn)用
  • 結(jié)尾

寫Markdown的工具

工欲善其事,必先利其器

作為初學(xué)者首先需要知道我們最好別用txt來(lái)寫Markdown,承認(rèn)有些人為了裝逼會(huì)用txt來(lái)寫代碼...我這里推薦 Atom秆撮。這里為了照顧不同操作系統(tǒng)的你四濒,不要有編輯器門戶之爭(zhēng)!當(dāng)然Mac下使用Macdown或者M(jìn)ou也挺好。

Atom

Atom官網(wǎng):點(diǎn)擊去往Atom官網(wǎng)盗蟆。點(diǎn)進(jìn)去之后會(huì)看到一個(gè)大大的 Download 按鈕的啦戈二。

大大的Download

一步步安裝,打開(kāi)Atom喳资。事實(shí)上Atom會(huì)自帶Markdown的插件的觉吭,但是不知道為什么我的不行。所以得去下載一個(gè)插件:<mark>Markdown-Preview-Plus</mark>仆邓。下面是安裝插件的具體步驟:

1.找到“設(shè)置”(cmd+, | win下在左上角的菜單欄就有了)

找到“設(shè)置”

2.點(diǎn)進(jìn)“install”鲜滩,點(diǎn)進(jìn)去輸入 Markdown-Preview-plus 搜索,出現(xiàn)第一個(gè)點(diǎn)擊“install”节值,我這邊已經(jīng)裝了所以就沒(méi)有install了徙硅,看下一個(gè)插件就有“install”了。

安裝Markdown-Preview-plus插件

3.然后點(diǎn)進(jìn)Packages里面搞疗,搜索mark嗓蘑,把Markdown-Preview進(jìn)行disable操作。

disable.png

3.拖進(jìn)一個(gè)文件夾到Atom中匿乃,并在這個(gè)文件夾下面創(chuàng)建一個(gè) test.md 文件桩皿,md就是Markdown縮寫嘛。注意:一定要有后綴名哦~幢炸。

4.打開(kāi)這個(gè)Markdown文件业簿,試試在里面輸入一些文字啥的。哎阳懂,感覺(jué)沒(méi)反應(yīng)是不是梅尤?現(xiàn)在Cmd+Shift+p(Win下Ctrl+Shift+p),在輸入框中輸入markdown岩调,選擇“markdown preview plus:toggle”回車就好巷燥。

然后會(huì)出出現(xiàn)兩個(gè)屏。在第一個(gè)屏里面輸入下面文字号枕。

###### hello world
# hello world

如果產(chǎn)生下面效果缰揪,那么說(shuō)明你完成了配置:
![Uploading test_394032.png . . .]

成功配置

其實(shí)呢,我們下的Atom僅僅是個(gè)編輯器葱淳,需要一些插件來(lái)幫助我們顯示markdown的預(yù)覽钝腺。而我下載的那個(gè)插件就是為了預(yù)覽的。事實(shí)上不下載那個(gè)插件也是可以的赞厕,建議先從第3步開(kāi)始看艳狐,不知道是不是我電腦的問(wèn)題我不能用Atom自帶的插件。

基本語(yǔ)法

搞了那么久終于開(kāi)始學(xué)習(xí)語(yǔ)法了皿桑。其實(shí)Markdown的本意就是為了簡(jiǎn)潔你的寫作毫目,所以別有太大的心里負(fù)擔(dān)蔬啡。后面我會(huì)給個(gè)小小例子來(lái)幫助大家一起實(shí)踐。現(xiàn)在打開(kāi)剛剛創(chuàng)建的test.md文件一起跟著我練習(xí)吧镀虐。

1.字體大小

輸入如下

###### hello world
##### hello world
#### hello world
### hello world
## hello world
# hello world

展現(xiàn)效果:

hello world
hello world

hello world

hello world

hello world

hello world

注意:這里只有1~6個(gè)#號(hào)箱蟆,7個(gè)就不行了,不信試試刮便。

2.引用塊

輸入如下:

> 您的好友已上線
> > 黑百合報(bào)道
> > 半藏報(bào)道
> > > **這游戲還能不能玩了空猜?**   (此處有三個(gè)空格哦~否則不換行)
> > > **感覺(jué)隊(duì)伍少了兩個(gè)人**

展示效果

您的好友已上線

黑百合報(bào)道
半藏報(bào)道

這游戲還能不能玩了?
感覺(jué)隊(duì)伍少了兩個(gè)人

3.強(qiáng)調(diào)

輸入如下

**Strong** *Lean*

__Strong__ _Lean_

展現(xiàn)效果

Strong Lean

Strong Lean

注意:對(duì)恨旱,你沒(méi)看錯(cuò)辈毯,兩種效果一樣的,選一個(gè)就行窖杀。

4.圖片

首先放一張圖到這個(gè)目錄下,與test.dm同級(jí)的裙士,嗯入客,叫test.png吧。

輸入如下:

![](test.png)
![MacDown logo](http://upload-images.jianshu.io/upload_images/2979799-9e844c1c9daf991c.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

展示效果

Test圖片滴
MacDown logo

一種本地圖片腿椎,一種網(wǎng)上圖片桌硫。格式為:![](圖片路徑)。在Atom上貌似不能顯示圖片下標(biāo)啃炸,但是在簡(jiǎn)書上面是可以的铆隘。還有,寫簡(jiǎn)書的人要注意了:如果你引用本地圖片寫文章南用,在簡(jiǎn)書編輯器上面一定要將圖片拖拽到簡(jiǎn)書的編輯器上面膀钠,否則本地文件簡(jiǎn)書怎么獲取啊。

5.超鏈接

輸入如下

[Baidu](http://www.baidu.com)

展示效果

Baidu

這個(gè)就不用解釋了吧裹虫,吧感嘆號(hào)去掉就變成超鏈接了肿嘲。

6.顯示代碼

輸入如下

~~~java
  public void hello();
~~~
```java
  public void hello();
```

展示效果

  public void hello();
  public void hello();

沒(méi)錯(cuò),又是兩種都行筑公,隨便挑一個(gè)雳窟。需要注意的是:可以在一開(kāi)始顯示需要高亮哪種語(yǔ)言風(fēng)格,我這里就用java了匣屡,你可以試試xml封救,html,c都是可以的捣作。

7.表格

輸入如下

First Header  | Second Header
------------- | -------------
Content Cell  | Content Cell
Content Cell  | Content Cell

You can align cell contents with syntax like this:

| Left Aligned  | Center Aligned  | Right Aligned |
|:------------- |:---------------:| -------------:|
| col 3 is      | some wordy text |         $1600 |
| col 2 is      | centered        |           $12 |
| zebra stripes | are neat        |            $1 |

展示效果

First Header Second Header
Content Cell Content Cell
Content Cell Content Cell

You can align cell contents with syntax like this:

Left Aligned Center Aligned Right Aligned
col 3 is some wordy text $1600
col 2 is centered $12
zebra stripes are neat $1

看看冒號(hào)在哪誉结,就往哪對(duì)其。

8.分割線

輸入如下

---

展示效果

3個(gè)短橫線就夠了券躁,你寫100個(gè)也是可以的搓彻。

9.分點(diǎn)

輸入如下

1. One
2. Two
3. Three

展示效果

  1. One
  2. Two
  3. Three

注意在小數(shù)點(diǎn)的后面需要一個(gè)空格哦

實(shí)踐運(yùn)用

學(xué)了一點(diǎn)點(diǎn)知識(shí)如绸,想記住他就多打打字就能記住了。所以我提供兩個(gè).md文件給大家練習(xí)旭贬,大家可以看看里面的內(nèi)容怔接,照著內(nèi)容寫一下,多練練稀轨。第一個(gè)是我寫的一個(gè)Spring的基本筆記扼脐,第二個(gè)是MacDown官網(wǎng)上的Markdown幫助手冊(cè)。

參考實(shí)例:Spring的基本筆記

參考實(shí)例:Macdown參考手冊(cè)

結(jié)尾

是不是覺(jué)得知識(shí)都很少奋刽?沒(méi)錯(cuò)瓦侮,就是很少的,這些基本知識(shí)可以應(yīng)付99.9%的寫作了佣谐。如果要更多(其實(shí)也沒(méi)多少)技巧肚吏,可以參考Macdown參考手冊(cè)(實(shí)踐運(yùn)用的第二個(gè)鏈接,雖然是英文版的狭魂,但是你看效果就知道發(fā)生了什么)罚攀。

當(dāng)然了,如果知道怎么寫Html代碼的同學(xué)雌澄,也是可以往這Markdown文件里面標(biāo)簽的斋泄,例如:<mark>嘿嘿嘿</mark>就變成<mark>嘿嘿嘿</mark>`

還有一些換行規(guī)則的镐牺,例如直接換行是換不了行的炫掐。可以試試空格空格空格+換行來(lái)進(jìn)行軟換行睬涧,而換行+換行則是硬換行募胃。通俗點(diǎn)就是文章?lián)Q行時(shí)候是不是會(huì)多出一個(gè)大空白的地方

好了畦浓,到最后希望大家可以一起進(jìn)步吧摔认,多巧文字,慢慢學(xué)會(huì)Markdown宅粥。

\^O^/

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末参袱,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子秽梅,更是在濱河造成了極大的恐慌抹蚀,老刑警劉巖,帶你破解...
    沈念sama閱讀 211,123評(píng)論 6 490
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件企垦,死亡現(xiàn)場(chǎng)離奇詭異环壤,居然都是意外死亡,警方通過(guò)查閱死者的電腦和手機(jī)钞诡,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 90,031評(píng)論 2 384
  • 文/潘曉璐 我一進(jìn)店門郑现,熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái)湃崩,“玉大人,你說(shuō)我怎么就攤上這事接箫≡芏粒” “怎么了?”我有些...
    開(kāi)封第一講書人閱讀 156,723評(píng)論 0 345
  • 文/不壞的土叔 我叫張陵辛友,是天一觀的道長(zhǎng)薄扁。 經(jīng)常有香客問(wèn)我,道長(zhǎng)废累,這世上最難降的妖魔是什么邓梅? 我笑而不...
    開(kāi)封第一講書人閱讀 56,357評(píng)論 1 283
  • 正文 為了忘掉前任,我火速辦了婚禮邑滨,結(jié)果婚禮上日缨,老公的妹妹穿的比我還像新娘。我一直安慰自己掖看,他們只是感情好匣距,可當(dāng)我...
    茶點(diǎn)故事閱讀 65,412評(píng)論 5 384
  • 文/花漫 我一把揭開(kāi)白布。 她就那樣靜靜地躺著乙各,像睡著了一般墨礁。 火紅的嫁衣襯著肌膚如雪幢竹。 梳的紋絲不亂的頭發(fā)上耳峦,一...
    開(kāi)封第一講書人閱讀 49,760評(píng)論 1 289
  • 那天,我揣著相機(jī)與錄音焕毫,去河邊找鬼蹲坷。 笑死,一個(gè)胖子當(dāng)著我的面吹牛邑飒,可吹牛的內(nèi)容都是我干的循签。 我是一名探鬼主播,決...
    沈念sama閱讀 38,904評(píng)論 3 405
  • 文/蒼蘭香墨 我猛地睜開(kāi)眼疙咸,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼县匠!你這毒婦竟也來(lái)了?” 一聲冷哼從身側(cè)響起撒轮,我...
    開(kāi)封第一講書人閱讀 37,672評(píng)論 0 266
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤乞旦,失蹤者是張志新(化名)和其女友劉穎,沒(méi)想到半個(gè)月后题山,有當(dāng)?shù)厝嗽跇?shù)林里發(fā)現(xiàn)了一具尸體兰粉,經(jīng)...
    沈念sama閱讀 44,118評(píng)論 1 303
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 36,456評(píng)論 2 325
  • 正文 我和宋清朗相戀三年顶瞳,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了玖姑。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片愕秫。...
    茶點(diǎn)故事閱讀 38,599評(píng)論 1 340
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡,死狀恐怖焰络,靈堂內(nèi)的尸體忽然破棺而出戴甩,到底是詐尸還是另有隱情,我是刑警寧澤舔琅,帶...
    沈念sama閱讀 34,264評(píng)論 4 328
  • 正文 年R本政府宣布等恐,位于F島的核電站,受9級(jí)特大地震影響备蚓,放射性物質(zhì)發(fā)生泄漏课蔬。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 39,857評(píng)論 3 312
  • 文/蒙蒙 一郊尝、第九天 我趴在偏房一處隱蔽的房頂上張望二跋。 院中可真熱鬧,春花似錦流昏、人聲如沸扎即。這莊子的主人今日做“春日...
    開(kāi)封第一講書人閱讀 30,731評(píng)論 0 21
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)谚鄙。三九已至,卻和暖如春刁绒,著一層夾襖步出監(jiān)牢的瞬間闷营,已是汗流浹背。 一陣腳步聲響...
    開(kāi)封第一講書人閱讀 31,956評(píng)論 1 264
  • 我被黑心中介騙來(lái)泰國(guó)打工知市, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留傻盟,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 46,286評(píng)論 2 360
  • 正文 我出身青樓嫂丙,卻偏偏與公主長(zhǎng)得像娘赴,于是被迫代替她去往敵國(guó)和親跟啤。 傳聞我的和親對(duì)象是個(gè)殘疾皇子诽表,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 43,465評(píng)論 2 348

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

  • 發(fā)現(xiàn) 關(guān)注 消息 iOS 第三方庫(kù)、插件竿奏、知名博客總結(jié) 作者大灰狼的小綿羊哥哥關(guān)注 2017.06.26 09:4...
    肇東周閱讀 12,059評(píng)論 4 62
  • 單主模式Keepalive之Nginx 調(diào)度 實(shí)驗(yàn)?zāi)康模?實(shí)現(xiàn)Nginx調(diào)度的高可用,當(dāng)一臺(tái)Nginx調(diào)度器故障時(shí)...
    芷_念閱讀 727評(píng)論 0 7
  • 每天來(lái)到簡(jiǎn)書碼字的時(shí)間捉片,也是我和自己對(duì)話的時(shí)間汞舱。 今天早上在看書的時(shí)候,看著看著心中升起了喜悅宗雇。書上說(shuō)赔蒲,你先要懂得...
    小easy閱讀 231評(píng)論 3 0
  • 近來(lái)泌神,關(guān)于出軌的丑聞是一浪蓋一浪,以至于吃瓜群眾對(duì)“出軌”這兩個(gè)字已漸漸麻木舞虱,甚至于對(duì)婚姻開(kāi)始恐懼欢际,其實(shí)沒(méi)必要拿別...
    小蠻婆顏究社閱讀 1,252評(píng)論 6 12