本文主要內(nèi)容包括:markdwon的基本語(yǔ)法和使用技巧。
相關(guān)文檔
概述
宗旨
易讀易寫
編輯工具
- Mou
Mac OS X 系統(tǒng)可以使用雁仲,支持實(shí)時(shí)預(yù)覽功能 - Atom
多端可以使用凤藏,就是效率很低球凰。有時(shí)候很卡。 - 簡(jiǎn)書
Web端使用簡(jiǎn)書編輯也是不錯(cuò)的選擇。可以保存在云端扬跋。
兼容 HTML
- 區(qū)塊元素(
<div>
<table>
<pre>
<p>
)
這是一個(gè)普通的段落钦听。這是一個(gè)普通的段落。 <table> <tr> <td>*Hello*</td> <td>Word</td> </tr> </table> 這是另外一個(gè)段落凌节。
<table><tr><td>Hello</td><td>Word</td></tr></table>
這是另外一個(gè)段落。 - HTML 區(qū)塊標(biāo)簽間的 Markdown 格式語(yǔ)法將不會(huì)被處理
- 行內(nèi)標(biāo)簽(
<span>
<cite>
<del>
)可以隨意使用 -
<a>
<img>
可以直接使用
<a >百度</a>
<a >百度</a>
- 特殊字符自動(dòng)轉(zhuǎn)換
AT&TAT&T ?
?
基本符號(hào)
-
*,-,+
3個(gè)符號(hào)效果都一樣倍奢,這3個(gè)符號(hào)被稱為Markdown符號(hào) - 空白行表示另起一個(gè)段落
-
`
是表示inline代碼朴上,tab是用來(lái)標(biāo)記 代碼段,分別對(duì)應(yīng)html的code卒煞,pre標(biāo)簽
區(qū)塊元素
段落和換行
段落是由前后一個(gè)以上的空行產(chǎn)生的痪宰,普通段落不該用空格或制表符來(lái)縮進(jìn)。
標(biāo)題
-
Setext 形式
這是 H1 ============= 這是 H2 -------------
-
atx 形式
# 這是 H1 ## 這是 H2 ###### 這是 H6
區(qū)塊引用 Blockquotes
> 這是一個(gè)區(qū)塊引用
Markdown 也允許你偷懶只在整個(gè)段落的第一行最前面加上 >
>> 區(qū)塊引用可以嵌套
>>> 區(qū)塊引用可以嵌套
>>> - 這是第一行列表項(xiàng)畔裕。
>>> - 這是第二行列表項(xiàng)衣撬。
>> 區(qū)塊引用可以嵌套
> 區(qū)塊引用可以嵌套
這是一個(gè)區(qū)塊引用
Markdown 也允許你偷懶只在整個(gè)段落的第一行最前面加上>
區(qū)塊引用可以嵌套
區(qū)塊引用可以嵌套
- 這是第一行列表項(xiàng)。
- 這是第二行列表項(xiàng)扮饶。
區(qū)塊引用可以嵌套
區(qū)塊引用可以嵌套
列表
無(wú)序列表使用星號(hào)淮韭、加號(hào)或是減號(hào)作為列表標(biāo)記:
* Red
- Green
+ Blue
- Red
- Green
- Blue
有序列表則使用數(shù)字接著一個(gè)英文句點(diǎn)
1. Bird
第二段
第三段
2. McHale
> 這是一個(gè)區(qū)塊引用
> 這是一個(gè)區(qū)塊引用
3. Parish
4. 一列表項(xiàng)包含一個(gè)列表區(qū)塊:
<代碼寫在這>
1986. 有序列表前面的序號(hào)不起作用
1986\. 避免這種`數(shù)字-句點(diǎn)-空白`生成列表
Bird
第二段
第三段McHale
這是一個(gè)區(qū)塊引用
這是一個(gè)區(qū)塊引用
- Parish
- 一列表項(xiàng)包含一個(gè)列表區(qū)塊:
代碼寫在這
- 有序列表前面的序號(hào)不起作用
1986. 避免這種數(shù)字-句點(diǎn)-空白
生成列表
代碼區(qū)塊
markdwon語(yǔ)法
縮進(jìn) 4 個(gè)空格或是 1 個(gè)制表符
這是一個(gè)普通段落:
這是一個(gè)代碼區(qū)塊。
import java.io.*;
這是一個(gè)普通段落:
這是一個(gè)代碼區(qū)塊贴届。
import java.io.*;
<div class="footer">
? 2004 Foo Corporation
</div>
`這是一個(gè)代碼區(qū)塊`
這是一個(gè)代碼區(qū)塊
<pre>
'''
這是一個(gè)代碼區(qū)塊
'''
</pre>
這是一個(gè)代碼區(qū)塊
html方式
<pre>
<code>
分隔線
***
* * *
---
- - -
表格(擴(kuò)展的markdown才支持)
注意冒號(hào)是對(duì)齊方式
| Tablees | Are | Coll |
| ----------:|:-------------:|:------|
| col 3 is | right-aligned | $160 |
| col 2 is | centered | $12 |
| col 2 is | centered | $12 |
Tablees | Are | Coll |
---|---|---|
col 3 is | right-aligned | $160 |
col 2 is | centered | $12 |
col 2 is | centered | $12 |
流程圖
st=>start: Start
i=>inputoutput: 輸入年份n
cond1=>condition: n能否被4整除?
cond2=>condition: n能否被100整除?
cond3=>condition: n能否被400整除毫蚓?
o1=>inputoutput: 輸出非閏年
o2=>inputoutput: 輸出非閏年
o3=>inputoutput: 輸出閏年
o4=>inputoutput: 輸出閏年
e=>end
st->i->cond1
cond1(no)->o1->e
cond1(yes)->cond2
cond2(no)->o3->e
cond2(yes)->cond3
cond3(yes)->o2->e
cond3(no)->o4->e
插入LaTeX公式
- 使用MathJax引擎
<script type="text/javascript"
src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=default">
</script>
使用Tex寫公式占键。$$公式$$
表示行間公式,本來(lái)Tex中使用(公式)表示行內(nèi)公式元潘,但因?yàn)镸arkdown中\(zhòng)是轉(zhuǎn)義字符畔乙,所以在Markdown中輸入行內(nèi)公式使用\(公式\),如下代碼:
$$x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}$$
\\(x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}\\)
$$x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}$$
\(x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}\)
區(qū)段元素
強(qiáng)調(diào)
*斜體* _斜體_
**粗體** __粗體__
~~刪除線~~
<u>下劃線</u>
上標(biāo)<sup>2</sup>
下標(biāo)<sub>2</sub>
斜體 斜體
粗體 粗體
刪除線
<u>下劃線</u>
上標(biāo)2
下標(biāo)2
鏈接
-
行內(nèi)式
這是一個(gè)[行內(nèi)式的鏈接](http://tech.xchance.xyz "可選的title") 這是一個(gè)[相對(duì)路徑的連鏈接](/about "可選的title")
這是一個(gè)行內(nèi)式的鏈接
這是一個(gè)相對(duì)路徑的連鏈接 -
參考式
這是一個(gè)[參考式的連接] [1]
[1]: http://tech.xchance.xyz "Github 個(gè)人主頁(yè)"
[2]: <http://tech.xchance.xyz> "Github 個(gè)人主頁(yè)"
[3]: http://tech.xchance.xyz 'Github 個(gè)人主頁(yè)'
[4]: http://tech.xchance.xyz (Github 個(gè)人主頁(yè))
參考式的連接
隱式鏈接標(biāo)記:[Google Address][]
[Google Address]: http://google.com/
[Google Address][]
[Google Address]: http://google.com/
[id]: http://tech.xchance.xyz -
簡(jiǎn)寫Url
<http://tech.xchance.xyz> <catchance@163.com>
圖片
類似鏈接方式同樣支持行內(nèi)式翩概、參考式和<img>
hexo好像不支持可選文字
![Alt text](http://tech.xchance.xyz/favicon.ico)
![Alt text](http://tech.xchance.xyz/favicon.ico)
![Alt text][id]
[id]: url/to/image "Optional title attribute"
注腳
原始Markdown語(yǔ)法好像不支持牲距,不過(guò)有些Blog是支持的
這是一個(gè)注腳[^footer]
[^footer]: 這是一個(gè)注腳
這是一個(gè)注腳 [1]
頁(yè)內(nèi)跳轉(zhuǎn)
定義錨點(diǎn): <span id="jump"> hello world </span>
使用錨點(diǎn): [hello](#jump)
定義錨點(diǎn): <span id="jump"> hello world </span>
使用錨點(diǎn): hello
技巧
- 使用兩個(gè)以上的空格然后回車插入
<br />
標(biāo)簽 - 特殊字符需要
\
字符來(lái)轉(zhuǎn)義:
\ ` * _ {} [] () # + - . !
- 如果要在代碼區(qū)段內(nèi)插入反引號(hào),你可以用多個(gè)反引號(hào)來(lái)開(kāi)啟和結(jié)束代碼區(qū)段
代碼塊中插入反引號(hào):`` ` ``
代碼塊中插入反引號(hào):`
- 段首縮進(jìn)技巧:
切換到全角模式下(一般的中文輸入法都是按 shift + space)輸入兩個(gè)空格就行了 - 文章中插入注釋的話钥庇,可以使用``
名詞解釋
<span id ="ref1">空行</span> 顯示上看起來(lái)像是空的牍鞠,便會(huì)被視為空行。比方說(shuō)评姨,若某一行只包含空格和制表符难述,則該行也會(huì)被視為空行
-
這是一個(gè)注腳 ?