孰能生巧
寫在前面
簡(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 按鈕的啦戈二。
一步步安裝,打開(kāi)Atom喳资。事實(shí)上Atom會(huì)自帶Markdown的插件的觉吭,但是不知道為什么我的不行。所以得去下載一個(gè)插件:<mark>Markdown-Preview-Plus</mark>仆邓。下面是安裝插件的具體步驟:
1.找到“設(shè)置”(cmd+, | win下在左上角的菜單欄就有了)
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”了。
3.然后點(diǎn)進(jìn)Packages里面搞疗,搜索mark嗓蘑,把Markdown-Preview進(jìn)行disable操作。
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)
展示效果
一種本地圖片腿椎,一種網(wǎng)上圖片桌硫。格式為:![](圖片路徑)
。在Atom上貌似不能顯示圖片下標(biāo)啃炸,但是在簡(jiǎn)書上面是可以的铆隘。還有,寫簡(jiǎn)書的人要注意了:如果你引用本地圖片寫文章南用,在簡(jiǎn)書編輯器上面一定要將圖片拖拽到簡(jiǎn)書的編輯器上面膀钠,否則本地文件簡(jiǎn)書怎么獲取啊。
5.超鏈接
輸入如下
[Baidu](http://www.baidu.com)
展示效果
這個(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
展示效果
- One
- Two
- 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è)。
結(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^/