出發(fā)點(diǎn)
我是一個(gè)比較懶的人骨饿,平時(shí)看書(shū)看了也就是看了,并沒(méi)有把自己看書(shū)的心得體會(huì)做一個(gè)總結(jié)并記錄下來(lái),然而歲月就像一把殺豬刀粒竖,很多東西自己想回頭用的時(shí)候發(fā)現(xiàn)已經(jīng)記不大清楚了[保持微笑],這不免又得重新去找相關(guān)的資料几于,真的是費(fèi)時(shí)費(fèi)力[保持微笑]蕊苗。所以我不得不強(qiáng)迫自己做筆記。
磨刀不誤砍柴工沿彭,做筆記也是需要講究效率的朽砰,在找尋一遍資料后,覺(jué)得用markdown做筆記實(shí)在是太便利了喉刘,它功能強(qiáng)大瞧柔,語(yǔ)法也很簡(jiǎn)單,花個(gè)幾分鐘大概就能掌握它的語(yǔ)法了∧郎眩現(xiàn)在很多云筆記造锅,博客后臺(tái)也都支持了Markdown的語(yǔ)法,可以說(shuō)是做筆記的一大利器了廉邑。
在這里我推薦一款免費(fèi)又專業(yè)的Markdown編輯工具--Typora,它目前只支持電腦端哥蔚,Mac Os、Windows蛛蒙、Linux系統(tǒng)都支持糙箍,Windows下載網(wǎng)址在這里,選擇跟你們電腦操作系統(tǒng)相匹配的版本安裝就可以了牵祟。
下面是Markdown的一些語(yǔ)法介紹深夯,花個(gè)幾分鐘基本就能看完了,這里有個(gè)問(wèn)題就是诺苹,在簡(jiǎn)書(shū)上的Markdown編輯器有些語(yǔ)法并不支持咕晋,例如:[TOC]目錄雹拄,表情包,腳注捡需,高亮等办桨,但是在Typora上是可以支持的,所以一款專業(yè)的Markdown編輯器還是很有必要的站辉。輸出是學(xué)習(xí)的最好的方式呢撞,把自己所學(xué)到的能清楚的講給別人聽(tīng),那應(yīng)該是很好的理解了吧饰剥。希望對(duì)大家有所幫助:smile:
Markdown For Typora
概覽
Markdown是由Daring Fireball創(chuàng)建的殊霞;原始的導(dǎo)向在這里。但是汰蓉,它的語(yǔ)法在不同的解析器或編輯器之間有所不同绷蹲。Typora正在使用GitHub Flavored Markdown.
[TOC]
塊元素
段落和換行
一個(gè)段落是一行或多行連續(xù)行文檔,在markdown源碼中顾孽,段落是通過(guò)兩個(gè)或多個(gè)空行來(lái)進(jìn)行分隔的祝钢。對(duì)于Typora,你僅需要一個(gè)空行(按回車鍵)去創(chuàng)建一個(gè)新的段落若厚。
按壓shift+回車鍵去創(chuàng)建一個(gè)單行換行拦英。大部分其他markdown解析器會(huì)忽視單行換行,為了讓其他markdown解析器識(shí)別你的換行测秸,你可以在行末留兩個(gè)空格或者在行末插入
標(biāo)題
標(biāo)題可以在行首使用1-6個(gè)#號(hào)字符疤估,對(duì)應(yīng)于標(biāo)題級(jí)別1-6。
例如:
# This is an H1
## This is an H2
###### This is an H6
在Typora中霎冯, 輸入'#'s后跟標(biāo)題內(nèi)容铃拇,然后按回車鍵將創(chuàng)建一個(gè)標(biāo)題。(注意:#號(hào)和標(biāo)題間是有一個(gè)空格的沈撞,后面的符號(hào)和內(nèi)容之間同理)
塊引用
markdown 使用郵件風(fēng)格符號(hào)‘>’進(jìn)行塊引用慷荔,它們呈現(xiàn)像這樣:
> This is a blockquote with two paragraphs. This is first paragraph.
>
> This is second pragtaph. Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, tisus.
> This is another blockquote with one paragraph. There is three empty line to seperate two blockquote.
> Nested bock quotes by adding additional levels of '>'
上面顯示的是源碼效果,它們?cè)谖臋n中顯示的效果如下:
This is a blockquote with two paragraphs. This is first paragraph.
This is second pragtaph. Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, tisus.
This is another blockquote with one paragraph. There is three empty line to seperate two blockquote.
Nested bock quotes by adding additional levels of '>'
在Typora中缠俺,輸入'>'后跟你引用的內(nèi)容將會(huì)生成一個(gè)引用塊拧廊。Typora將會(huì)為你插入一個(gè)恰當(dāng)?shù)?>'或者換行符。嵌套塊引用(一個(gè)塊引用里引用另一個(gè)塊引用)通過(guò)添加'>'的附加級(jí)別晋修。
列表
輸入* 列表?xiàng)l目1將會(huì)創(chuàng)建一個(gè)無(wú)序列表,*符號(hào)可以被+或者-號(hào)替換凰盔。
輸入1.列表?xiàng)l目1將會(huì)創(chuàng)建一個(gè)有序列表墓卦,它們的markdown源碼像下面這樣:
### 無(wú)序列表
* 紅色
* 綠色
* 藍(lán)色
### 有序列表
1. 紅色
2. 綠色
3. 藍(lán)色
在文檔中顯示的效果如下:
無(wú)序列表
- 紅色
- 綠色
- 藍(lán)色
有序列表
- 紅色
- 綠色
- 藍(lán)色
任務(wù)列表
任務(wù)列表是帶有標(biāo)記為[ ]或[X]的項(xiàng)的列表[ ]代表沒(méi)完成, [X]代表完成户敬。例如:
- [ ] 一個(gè)任務(wù)列表?xiàng)l目
- [ ] 列表語(yǔ)法要求
- [ ] 正常格式 **格式**落剪, @提及睁本, #1234 refs
- [ ] 沒(méi)完成
- [x] 完成
在文檔中顯示的效果如下:
- [ ] 一個(gè)任務(wù)列表?xiàng)l目
- [ ] 列表語(yǔ)法要求
- [ ] 正常格式 格式, @提及忠怖, #1234 refs
- [ ] 沒(méi)完成
- [x] 完成
你可以改變完成/沒(méi)完成的狀態(tài)通過(guò)點(diǎn)擊條目前邊的可選框呢堰。
(受控)代碼塊
Typora 僅支持GitHub Flavored Markdown中的柵欄,不支持markdown中的原始代碼塊凡泣。
使用柵欄很簡(jiǎn)單:輸入```然后按回車鍵枉疼。在三點(diǎn)之后添加一個(gè)可選的語(yǔ)言標(biāo)識(shí)符,我們將通過(guò)語(yǔ)法高亮它鞋拟,如下:
Here's an example:
?```javascript
function test() {
console.log("notice the blank line before this function?");
}
?```
syntax highlighting:
?```python
def hello():
markdown = "hello world !!!"
print(markdown)
?```
在文檔中的效果如下:
Here's an example:
function test() {
console.log("notice the blank line before this function?");
}
syntax highlighting:
def hello():
markdown = "hello world !!!"
print(markdown)
數(shù)學(xué)塊
你可以使用MathJax渲染LaTeXs數(shù)學(xué)表達(dá)式骂维。添加一個(gè)數(shù)學(xué)表達(dá)式,輸入$$
然后按回車鍵贺纲。將會(huì)觸發(fā)一個(gè)輸入欄來(lái)接受Tex/LaTex 源碼航闺,例如數(shù)學(xué)表達(dá)式:
在markdown源文件中,數(shù)學(xué)塊是一個(gè)通過(guò)一對(duì)’$$‘標(biāo)識(shí)符裝飾的LaTeX 表達(dá)式猴誊,源碼如下:
$$
\mathbf{V}_1 \times \mathbf{V}_2 = \begin{vmatrix}
\mathbf{i} & \mathbf{j} & \mathbf{k} \\
\frac{\partial X}{\partial u} & \frac{\partial Y}{\partial u} & 0 \\
\frac{\partial X}{\partial v} & \frac{\partial Y}{\partial v} & 0 \\
\end{vmatrix}
$$
想了解更多請(qǐng)單擊這里潦刃。
對(duì)于數(shù)學(xué)塊了解一下書(shū)寫(xiě)規(guī)則就好了,因?yàn)檩斎霐?shù)學(xué)表達(dá)式實(shí)在是太繁雜了懈叹,有興趣的可以自己去了解更多這方面的知識(shí)乖杠。
表格
輸入|First Header|Second Header|
然后按回車鍵,將會(huì)創(chuàng)建一個(gè)具有兩列的表格项阴。
創(chuàng)建表格之后滑黔,把光標(biāo)放置在表格上將會(huì)打開(kāi)一個(gè)工具欄,工具欄可以實(shí)現(xiàn)對(duì)表格的大小环揽,對(duì)齊方式進(jìn)行定制略荡,或者刪除表格。你也可以使用上下文菜單復(fù)制和添加/刪除個(gè)別列/行歉胶。
表格的全部語(yǔ)法描述如下汛兜,但是沒(méi)有必要去了解全部的語(yǔ)法細(xì)節(jié),因?yàn)樵赥ypora中markdown源碼會(huì)自動(dòng)生成表格通今。
在markdown源碼中粥谬,它們看起來(lái)像這樣:
| First Header | Second Header |
| ------------- | ------------- |
| Content Cell | Content Cell |
| Content Cell | Content Cell |
在文檔中,markdown解析器會(huì)根據(jù)你輸入的語(yǔ)法顯示成如下:
First Header | Second Header |
---|---|
Content Cell | Content Cell |
Content Cell | Content Cell |
你也可以在表格中包含內(nèi)聯(lián)markdown如:鏈接辫塌,粗體漏策,斜體,或者刪除線臼氨。
最后通過(guò)在標(biāo)題行中包含冒號(hào)(‘:’)你可以定義文檔在列中左對(duì)齊掺喻,右對(duì)齊或者居中對(duì)齊:
| Left-Aligned | Center Aligned | Right Aligned |
| :------------ |:---------------:| -----:|
| col 3 is | some wordy text | $1600 |
| col 2 is | centered | $12 |
| zebra stripes | are neat | $1 |
效果如下:
Left-Aligned | Center Aligned | Right Aligned |
---|---|---|
col 3 is | some wordy text | $1600 |
col 2 is | centered | $12 |
zebra stripes | are neat | $1 |
腳注
You can create footnotes like this[^footnote].
[^footnote]: Here is the *text* of the **footnote**.
將產(chǎn)生:
You can create footnotes like this[1].
將鼠標(biāo)停在“腳注”上可查看腳注的內(nèi)容。
橫向規(guī)則
在空行上輸入***或者---然后按回車鍵將畫(huà)出一條橫線
***
---
效果如下:
YAML Front Matter
Typora 現(xiàn)在支持YAML Front Matter在文章頂部輸入---然后按回車鍵來(lái)引入一個(gè)元數(shù)據(jù)塊。另外感耙,你可以在Typora的頂部菜單中插入一個(gè)元數(shù)據(jù)塊褂乍。
目錄(TOC)
輸入[toc]然后按回車鍵,將會(huì)創(chuàng)建一個(gè)目錄即硼,TOC會(huì)抽取出文檔中的所有標(biāo)題逃片,并且目錄會(huì)自動(dòng)更新當(dāng)你添加新的標(biāo)題時(shí)。
如我輸入[toc]按回車會(huì)出現(xiàn)如下目錄:
[TOC]
跨度元素
span元素將在鍵入之后立即解析和呈現(xiàn)只酥。將光標(biāo)移動(dòng)到這些span元素的中間會(huì)將這些元素?cái)U(kuò)展為markdown源碼褥实。下面是每個(gè)span元素的語(yǔ)法說(shuō)明。
鏈接
markdown支持兩種風(fēng)格的鏈接:內(nèi)聯(lián)鏈接和引用层皱。
在這兩種風(fēng)格樣式中性锭,鏈接文由[方括號(hào)]分隔。
創(chuàng)建一個(gè)內(nèi)聯(lián)鏈接叫胖,在鏈接文的結(jié)束方括號(hào)后面立即使用一組常規(guī)括號(hào)(圓括號(hào)),在圓括號(hào)里面草冈,寫(xiě)上你想鏈接去的目的地址,以及鏈接的可選標(biāo)題瓮增,用引號(hào)括起來(lái)怎棱。例如:
This is [an example](http://example.com/ "Title") inline link.
[This link](http://example.net/) has no title attribute.
形成效果如下:
This is an example inline link.
This link has no title attribute.
內(nèi)部鏈接
你可以為標(biāo)題設(shè)置href屬性,它將創(chuàng)建一個(gè)書(shū)簽绷跑,當(dāng)你點(diǎn)擊它的時(shí)候會(huì)跳轉(zhuǎn)到該標(biāo)題部分拳恋,例如:
命令(在windows中:Ctrl)+點(diǎn)擊鏈接將會(huì)跳轉(zhuǎn)到該標(biāo)題部分,為了看清楚怎么寫(xiě)砸捏,請(qǐng)移動(dòng)游標(biāo)或者點(diǎn)擊該鏈接將元素展開(kāi)為markdown源谬运。
引用鏈接
引用樣式鏈接使用第二組方括號(hào),在其中放置你選擇的標(biāo)簽以標(biāo)識(shí)鏈接:
This is [an example][id] reference-style link.
Then, anywhere in the document, you define your link label on a line by itself like this:
[id]: http://example.com/ "Optional Title Here"
在Typora中垦藏,它們將會(huì)被渲染成這樣:
This is an example reference-style link.
Then, anywhere in the document, you define your link label on a line by itself like this:
隱式鏈接名稱快捷方式允許你省略鏈接的名稱梆暖,在這種情況下,鏈接文本身將用作名稱掂骏。只需使用一組空方括號(hào) - 例如轰驳,將“Google”一詞鏈接到google.com網(wǎng)站,您就可以簡(jiǎn)單地寫(xiě)一下
[Google][]
And then define the link:
[Google]: http://google.com/
在Typora中弟灼,它們將會(huì)被渲染成這樣:
Google
And then define the link:
在Typora中级解,點(diǎn)擊這個(gè)鏈接將會(huì)展開(kāi)來(lái)可以編輯,用Ctrl+點(diǎn)擊鏈接可以用瀏覽器打開(kāi)這個(gè)超鏈接田绑。
URLs
Typora 允許你插入U(xiǎn)RLs作為鏈接勤哗,用<尖括號(hào)>包裹。
<i@typora.io>
變成i@typora.io.
Typora 將自動(dòng)鏈接標(biāo)準(zhǔn)的URLs. e.g:www.google.com
圖片
圖片和鏈接具有相似的語(yǔ)法掩驱,但是圖片要求添加一個(gè)芒划!
號(hào)在開(kāi)始的鏈接之前豁延。插入一張圖片的語(yǔ)法像這樣:
![images.jpg](https://upload-images.jianshu.io/upload_images/16340574-2467285ac934571a.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
你可以使用拖放操作從圖片文件或者web瀏覽器插入一張圖片。你可以修改markdown源碼通過(guò)點(diǎn)擊圖片腊状。如果使用拖放操作添加的圖像與您當(dāng)前正在編輯的文檔位于同一目錄或子目錄中,則將使用相對(duì)路徑苔可。
假如你使用markdown來(lái)構(gòu)建網(wǎng)站缴挖,你可以在本地計(jì)算機(jī)上為圖片預(yù)覽指定一個(gè)URL前綴,在YAML Front Matters 中使用屬性'typora-root-url'焚辅,例如映屋,在YAML Front Matters中輸入typora-root-url:/User/Abner/Website/typora.io,然后輸入![alt](/blog/img/test.png)
將被視為在Typora中![alt](file:///User/Abner/Website/typora.io/blog/img/test.png)
你可以找到更多詳情從這里同蜻。
突出重點(diǎn)
markdown 使用星號(hào)(*
)和下劃線(_
)作為突出重點(diǎn)棚点。文檔被一對(duì)*
或者_
包裹相當(dāng)于被HTML的<em>
標(biāo)簽包裹。
*single asterisks*
_single underscores_
在文檔中顯示的效果如下:
single asterisks
single underscores
GFM(GitHub Flavored Markdown)將忽視單詞中的下劃線湾蔓,這通常用于代碼和名稱瘫析,如下所示:
wow_great_stuff
do_this_and_do_that_and_another_thing.
要在其他方式用作強(qiáng)調(diào)分隔符的位置生成文字星號(hào)或者下劃線,可以使用反斜杠轉(zhuǎn)義:
\*this text is surrounded by literal asterisks\*
Typora 推薦使用*
號(hào)默责。
加粗
兩個(gè)*
或者_
包裹內(nèi)容將會(huì)當(dāng)做HTML中的<strong>
標(biāo)簽
**double asterisks**
__double asterisks__
在文檔中的顯示效果如下:
double asterisks
double asterisks
Typora推薦使用**
符號(hào)贬循。
代碼
在代碼中為了表明一個(gè)內(nèi)聯(lián)span,用反撇號(hào)包裹桃序。不像一個(gè)預(yù)格式化代碼塊杖虾,一個(gè)span表明代碼在正常的段落中,例如:
Use the `printf()`function.
在文檔中展示的效果如下:
Use the printf()
function.
刪除線
GFM添加創(chuàng)建刪除線文本的語(yǔ)法媒熊,這在標(biāo)準(zhǔn)標(biāo)記中是缺失的奇适。
~~Mistaken text.~~
變成Mistaken text.
下劃線
下劃線由原始HTML提供支持。
<u>Underline</u>
變成<u>Underline</u>
表情包 :smile:
輸入表情包語(yǔ)法:smile:
.
用戶可以通過(guò)按esc鍵觸發(fā)表情包的自動(dòng)完成建議芦鳍,或者在首選項(xiàng)面板上啟動(dòng)后自動(dòng)觸發(fā)嚷往。以上兩種觸發(fā)模式,通過(guò)進(jìn)入文件->偏好設(shè)置->emoji自動(dòng)完成進(jìn)行設(shè)置怜校,還支持直接輸入utf-8表情字符间影。
內(nèi)聯(lián)公式
要使用這個(gè)特性,請(qǐng)?jiān)谖募?>偏好設(shè)置->Markdown->markdown擴(kuò)展語(yǔ)法中啟用它茄茁,然后用$
符號(hào)去包裹TeX命令魂贬,例如:?$\lim_{x \to \infty} \exp(-x) = 0$
將會(huì)被渲染成LaTeX命令
為了觸發(fā)公式預(yù)覽效果,輸入"$"裙顽,然后按ESC鍵付燥,輸入公式的時(shí)候就可以看到預(yù)覽效果了。
要了解更多詳情請(qǐng)看這里愈犹。
下標(biāo)
要使用這個(gè)特性键科,請(qǐng)?jiān)谖募?>偏好設(shè)置->Markdown->markdown擴(kuò)展語(yǔ)法中啟用它闻丑,然后用~
符號(hào)去包裹下標(biāo)內(nèi)容,例如:H~2~O
,X~long\ text~
/
顯示的效果如下:
H2O勋颖,Xlong text
上標(biāo)
要使用這個(gè)特性嗦嗡,請(qǐng)?jiān)谖募?>偏好設(shè)置->Markdown->markdown擴(kuò)展語(yǔ)法中啟用它,然后用^
符號(hào)去包裹下標(biāo)內(nèi)容饭玲,例如:X^2^
顯示的效果如下:
X2
高亮
要是用此功能侥祭,請(qǐng)先在文件->偏好設(shè)置->Markdown選項(xiàng)卡中啟用它,然后使用==
來(lái)包裝高亮內(nèi)容茄厘。例如==highlight==
==highlight==
HTML
你可以使用HTML來(lái)設(shè)置純Markdown不支持的內(nèi)容樣式矮冬,例如:使用<span style="color:red">this text is red</span>
添加紅色文本
<span style="color:red">this text is red</span>
嵌入內(nèi)容
有些網(wǎng)站提供基于iframe的嵌入代碼,你也可以將其粘貼到Typora中次哈。例如:
<iframe height='265' scrolling='no' title='Fancy Animated SVG Menu' src='http://codepen.io/jeangontijo/embed/OxVywj/?height=265&theme-id=0&default-tab=css,result&embed-version=2' frameborder='no' allowtransparency='true' allowfullscreen='true' style='width: 100%;'></iframe>
顯示的效果如下:
<iframe height='265' scrolling='no' title='Fancy Animated SVG Menu' src='http://codepen.io/jeangontijo/embed/OxVywj/?height=265&theme-id=0&default-tab=css,result&embed-version=2' frameborder='no' allowtransparency='true' allowfullscreen='true' style='width: 100%;'></iframe>
視頻
你可以使用<video>
HTML標(biāo)簽來(lái)嵌套視頻胎署,例如:
<video src="xxx.mp4" />
<video src="xxx.mp4" />
其他HTML支持
你可以找到更多詳情從這里.