一. 為什么選擇 Markdown?
Markdown 是一種輕量級(jí)的富文本標(biāo)記語(yǔ)言,用戶可以通過(guò)純文本的形式,使用其特有的語(yǔ)法標(biāo)準(zhǔn),可以達(dá)到很好的效果展示。
同時(shí),使用 MarkDown 編寫(xiě)的文檔可以很輕易的轉(zhuǎn)化為包括 html 文本在內(nèi)的其他諸多形式的文件。這為我們的以后的處理文檔提供了很大的便利性。
其次,網(wǎng)上各種的在線編輯工具或者是本地的文本編輯工具都支持都支持 Markdown 語(yǔ)法書(shū)寫(xiě),這使得我們編寫(xiě) Markdown 文檔比較方便。
下面,來(lái)看看百度的說(shuō)法:
Markdown的語(yǔ)法簡(jiǎn)潔明了、學(xué)習(xí)容易,而且功能比純文本更強(qiáng),因此有很多人用它寫(xiě)博客。世界上最流行的博客平臺(tái)WordPress和大型CMS如Joomla、Drupal都能很好的支持Markdown。完全采用Markdown編輯器的博客平臺(tái)有Ghost和Typecho。
在數(shù)據(jù)科學(xué)領(lǐng)域,Markdown已經(jīng)被確立為科學(xué)研究規(guī)范,極大地推進(jìn)了動(dòng)態(tài)可重復(fù)性研究的歷史進(jìn)程。
所以說(shuō),使用 Markdown 語(yǔ)法編寫(xiě)文檔是一個(gè)不錯(cuò)的選擇。雖然我平時(shí)雖然書(shū)寫(xiě)文章比較少,但是,Markdown 的簡(jiǎn)便性,實(shí)用性,已經(jīng)深深的吸引了我。
二. Markdown 的基本語(yǔ)法。
首先貼一下中文語(yǔ)法鏈接 Markdown中文語(yǔ)法鏈接
MarkDown 的基本語(yǔ)法就是標(biāo)記符號(hào)的使用。原理應(yīng)該和瀏覽器解析 html 文的原理差不多。就是,Markdown 語(yǔ)句會(huì)默認(rèn)的規(guī)定一些關(guān)鍵字,當(dāng)解析器遇到這些關(guān)鍵字之后,就將關(guān)鍵字之后的特定長(zhǎng)度的內(nèi)容解析為相應(yīng)的格式,并通過(guò)某種格式展現(xiàn)出來(lái)。
- 標(biāo)題
Markdown 的標(biāo)題共分為 6 個(gè)等級(jí),使用 "#" 進(jìn)行標(biāo)識(shí),"#" 的數(shù)量表示它后面的內(nèi)容為第幾級(jí)標(biāo)題,建議在 # 后面加一個(gè)空格。
這篇文章的每個(gè)部分的開(kāi)頭就是一級(jí)標(biāo)題。使用的語(yǔ)句為:
# 一. 為什么選擇 Markdown ?
- 文本樣式
- 斜體:使用一個(gè) * 或者 _ 將所需要的內(nèi)容包裹
- 加粗:使用兩個(gè) * 或者 _ 將所需要的內(nèi)容包裹
- 刪除線:使用兩個(gè) ~ 將內(nèi)容包裹
- 高亮:使用兩個(gè) = 將內(nèi)容包裹
*斜體* _斜體2_
** 粗體** __粗體__
~~刪除線~~
==高亮==
斜體 斜體2
粗體 粗體2
刪除線
==高亮==
段落: 段落之間空一行
換行符: 一行結(jié)束時(shí)輸入兩個(gè)空格
列表:* 或者 - 或 + 成為一個(gè)新的列表項(xiàng),這個(gè)為無(wú)序列表?;煊脮?huì)出現(xiàn)比較大的空白間距。
需要添加有序列表則需要使用 數(shù)字+.+空格的形式。經(jīng)測(cè)試,與使用的序號(hào)關(guān)系不大,他是按照一個(gè)接一個(gè)的順序加上去的序號(hào)。
無(wú)序列表
* item1
* item2
- item3
- item4
有序列表
1. item1
2. item2
無(wú)序列表
- item1
- item2
- item3
- item4
- item5
- item6
有序列表
- item1
- item2
引用: > 引用內(nèi)容 ,上面的的效果就是引用來(lái)實(shí)現(xiàn)的
內(nèi)嵌代碼 : 單行使用 ` 將代碼包裹
多行使用 ``` 將代碼包裹
還可以使用每一行前面加4個(gè)空格標(biāo)記一個(gè)代碼段

#include<stdio.h>
int main(){
printf("hello!");
return 0;
}
boolean getMax(int a, int b){
return a >= b? a : b;
}
畫(huà)水平線:在一行中用三個(gè)以上的星號(hào)(*)、減號(hào)(-)、下劃線(_)來(lái)建立一個(gè)分隔線;除空格外行內(nèi)不能有其他字符;(除第一個(gè)符號(hào)的左側(cè)最多添加三個(gè)空格外)三個(gè)相同符號(hào)兩側(cè)可以添加任意多個(gè)空格。
___
---
***
- 鏈接
鏈接分為兩類:一類是普通的網(wǎng)絡(luò)鏈接,另外一類是圖片鏈接
普通鏈接為:[百度](https://www.baidu.com)
圖片鏈接為:
效果如下:
普通鏈接為:百度
圖片鏈接為:
- 表格
Markdown 的表格算是比較難寫(xiě)的。
第一行為各個(gè)列的表名稱。第二行為下面內(nèi)容的對(duì)齊方式,使用:進(jìn)行標(biāo)記。兩個(gè)冒號(hào)加上減號(hào) (-) 表示居中,減號(hào)后面是:表示居右,默認(rèn)居左。
| cloth | price |color |
| ------------- |:-------------:| -----:|
| 褲子 | 15R | 紅 |
| 襪子 | 2R | 黑 |
| cloth | price | color |
|---|---|---|
| 褲子 | 15R | 紅 |
| 襪子 | 2R | 黑 |
三. MarkDown 注意事項(xiàng)。
- 因?yàn)?Markdown 中的空格起著樣式控制的作用,所以很多時(shí)候很難直接輸入空格。因此我們可以使用 html語(yǔ)法中的方法
//半角空格(英文)
?//全角空格(中文)
我前面有空格。
? 我前面也有。
- Markdown 和 html 是兼容的。甚至可以直接在其中使用html語(yǔ)法的標(biāo)簽。
(但是顯然有道云筆記是不支持這種操作的,簡(jiǎn)書(shū)貌似也不支持。)
<table>
<tr>
<td>Foo</td>
</tr>
</table>