從事開發有一段時間了,在過程中,閱讀了許多的大牛寫的博客以及簡書文章,也自己寫了一些小的博客,認識到用Markdown的作用以及必要性。準備在工作學習之余,寫一寫自己在過程中遇到的問題,踩過的坑。好記性不如爛筆頭,于是乎開始了我的Markdown初步學習之路,為了方便記憶筆記與分享個人心得,邊學習邊寫下這份入門學習筆記。
作為一個純文本軟件的標記語言,Markdown相對來說比其他的更簡單,更方便。大部分作家用Word或Pages寫作,過去的文檔也大都以.doc,.docx格式或是Pages格式儲存。還有人為了保證文稿發給誰都能正常打開,會用.txt 格式。
.doc 或 Pages 格式有如下問題:
1 不一定誰都能打開。用 Windows 的人打不開 .pages 文件,用舊版 Word 的人不一定能打開你用新版 Word 寫的稿子。
2 對方看到的稿子的樣子和你自己看到的可能差別很大。
3 .Office 已經是你電腦上唯一的盜版軟件,導致心情不佳。
4 .txt 格式的問題在于沒有樣式:收到稿子的編輯和設計師可能不知道哪個是小標題,哪里需要斜體,哪里需要加粗。
這就是 Markdown 登場的時候了。
用 Markdown 有如下好處:
兼顧了「什么人都能打開」和「樣式」。Markdown 就是純文本,就是 txt,所以什么人都能打開。而如上所述,你可以用它來標記文本的樣式,而且語法非常簡單。
由于是純文本,Markdown 文稿也不會因為未來軟件升級而產生不同版本之間的兼容問題,即,不會出現「我這篇稿子是用舊版 Word 寫的,你用新版 Word 看可能格式會有點問題」的情況。
Markdown 轉 HTML 非常方便。HTML 是整個萬維網(web)的標記語言,但更重要的是,它也是目前主流電子書格式所用的標記語言。無論是 EPUB, mobi,還是 Kindle 用的專有格式 .azw,都只是把一堆 HTML 文件打包而已。如果你寫的是書,用 Markdown 標注格式之后,可以很方便地轉為以上格式(當然這個轉換工作不需要由你來做);如果你寫的是單篇的文章(例如新聞報道或專欄),未來也不排除結集出書的可能。若采用 Markdown,對于日后的文件轉換工作也大有裨益。
如何開始用 Markdown?繼續用你習慣的寫作軟件即可。記事本、Word、Pages 都沒問題,但請記得存成純文本格式。就這么簡單。
進入學習
—1.標題
這是最為常用的格式,在平時常用的的文本編輯器中大多是這樣實現的:輸入文本、選中文本、設置標題格式。
而在 Markdown 中,你只需要在文本前面加上 # 即可,同理、你還可以增加二級標題、三級標題、四級標題、五級標題和六級標題,總共六級,只需要增加 # 即可,標題字號相應降低。例如:
# 一級標題
## 二級標題
### 三級標題
#### 四級標題
##### 五級標題
###### 六級標題
注:# 和「一級標題」之間建議保留一個字符的空格,這是最標準的 Markdown 寫法。
以下是在另一篇博客里面看到的手寫圖片,我將其引用到本文中,方便參考學習:
—2.列表
書寫過程中,列表格式經常也會用到,在 Markdown 中,你只需要在文字前面加上 - 就可以了,例如:
- 文本1
- 文本2
- 文本3
如果你希望有序列表,
也可以在文字前面加上 1. 2. 3. 就可以了,例如:
- 文本1
- 文本2
- 文本3
注:-、1.和文本之間要保留一個字符的空格。
以下為列表文本示例截圖:
—3.鏈接和圖片
在Markdown中,如果要插入網址鏈接,方法是[顯示文本](鏈接地址)
,例如:
[簡書](http://www.lxweimin.com)
如果,你需要插入圖片,只需要使用如下格式:
就好,例如:

如圖:
—4.名言引用
如果在寫作過程中,我們需要引用別人的話或者說名人名言,在Markdown中,在引用文字之前加上>
即可,格式如下:
> 世間哪得雙全法,不負如來不負卿。
> 人生若只如初見,何事秋風悲畫扇。等閑變卻故人心,卻道故人心易變。
當然,>
與引用文本之間有一個空格符。
顯示結果如下:
世間哪得雙全法,不負如來不負卿
人生若只如初見,何事秋風悲畫扇。等閑變卻故人心,卻道故人心易變。
— 5. 文字格式
目前我所掌握的,在Markdown中一般采用粗體和斜體兩種方式:
- 用兩個
*
包含一段文本就是粗體文字; - 用一個
*
包含的一段文字就是斜體文字。
文本示例:
**世間哪得雙全法,不負如來不負卿。**
*人生若只如初見,何事秋風悲畫扇。等閑變卻故人心,卻道故人心易變。*
效果如下:
世間哪得雙全法,不負如來不負卿。
人生若只如初見,何事秋風悲畫扇。等閑變卻故人心,卻道故人心易變。
— 6. 代碼展示
如果我們在編寫過程中,需要引用我們項目中所用代碼,
- 如果只有一段,不換行,可以用
`
語句包起來; - 如果引用為多行,可以將
```
加在代碼段的首行和末行。
示例如下:
`hello world`
```
這是第一段代碼
這是第二段代碼
這是第三段代碼
```
— 7. 關于顏色
因為關于顏色方面本人不經常用,畢竟文章重點不在于顏色而是內容,所以,之前第一次寫這篇文章的時候并沒有去看顏色的使用方法,后面寫東西的時候恰巧遇到了,就貼過來,如果有需要可以看看:
<font face="黑體">這就是黑體字</font>
<font face="微軟雅黑">這是微軟雅黑</font>
<font face="STCAIYUN">然后是華文彩云</font>
<font color=#0099ff size=7 face="黑體">color=#0099ff size=72 face="黑體"</font>
<font color=#00ffff size=72>color=#00ffff</font>
<font color=gray size=72>color=gray</font>
效果如下:
Size:規定文本的尺寸大小。可能的值:從 1 到 7 的數字。瀏覽器默認值是 3。
親測簡書不支持此格式字體,如果有需要,參照博客: CSDN-markdown編輯器語法——字體、字號與顏色
總結:
以上6種Markdown常用語法,基本囊括了開發人員在書寫筆記及博客的所有所需要的方法內容,因為本人也是參考大牛之前的博客以及文章邊學邊寫,作為學習筆記之用,如果有什么不足之處,還望各位指出,謝謝。
更多關于Markdown其他語法,參見:Markdown語法說明