markdown已经活跃在世界的各个角落,楼主在博客园也使用了一段时间了,在此总结下markdown的用法。
首先介绍下几款工具,一般在windows下我就用 MarkdownPad ,在线的话可以试试 Markdown Live Editor ,或者参考 非常有用的 Markdown 编辑器和工具 、 用 Markdown 写作用什么文本编辑器?
要了解更多语法,可以参考 Markdown Cheatsheet ,或者中文版 markdown-语法说明
标题(h1~h6)可使用相应个数的 #
来生成,如下面的代码将会生成h3标题:
### this is a level-3 header ###
特别的,h1和h2还有一种生成方式,利用 =
(最高阶标题)和 -
(第二阶标题):
this is h1 === this is h2 ---
=和-的个数必须要三个或者以上。
使用 一个或多个 空行分隔内容段来生成段落( <p>
)
在行末输入 两个或以上 空格再回车来生成换行( <br/>
)
如果要插入多个空行,可以手动插入换行符 <br/>
被一个 *
或者 _
包围的文字将会被 <em>
标签包围:
*single asterisks* _single underscores_
被两个 *
或者 _
包围的文字将会被 <strong>
标签包围:
**double asterisks** __double underscores__
在一行内使用 三个或以上 的 *
和 _
来建立分隔线( <hr>
),行内除此之外不能有其他内容:
*** * * * * * * * * ___ _ _ _ _
使用 >
作为段落前缀来标识引用文字段落,引用可以嵌套。
> one day, I lost my lover > you know > > this is just a test
使用 *
+
-
来表示无序列表( <ul>
):
- apple - banana - orange
使用数字紧跟一个 .
再加空格来表示有序列表( <ol>
):
1. apple 2. banana 3. orange
使用反引号 `
来表示行内代码,这部分文字将会被 <code>
标签包围:
`markdown`
使用4个空格或者一个制表符(tab)缩进表示代码区块,它们将被 <pre>
和 <code>
包裹:
var a = 10 , b = 20;
行内式语法:
click [here](http://www.cnblogs.com/zichi/ 'zhichi/'s blog') click [here](http://www.cnblogs.com/zichi/)
参考式语法:
1. [JavaScript | MDN][1] 2. [ECMAScript 6 入门 阮一峰][2] 3. [InfoQ JavaScript][3] [1]: https://developer.mozilla.org/zh-CN/docs/Web/JavaScript [2]: http://es6.ruanyifeng.com/ 'RuanYifeng' [3]: http://www.infoq.com/cn/javascript/?utm_source=infoq&utm_medium=header_graybar&utm_campaign=topic_clk
参考式语法这样的链接定义,你可以把它放到文章的任意位置。
自动链接:
<http://www.cnblogs.com/zichi/> <hanzichi@outlook.com>
隐式链接标记:
I get 10 times more traffic from [Google][] than from [Yahoo][] or [MSN][]. [google]: http://google.com/ "Google" [yahoo]: http://search.yahoo.com/ "Yahoo Search" [msn]: http://search.msn.com/ "MSN Search"
图片的语法和链接相似,也有行内式和参考式两种。
行内式:
![avater](http://pic.cnblogs.com/avatar/675542/20150612173854.png) ![avater](http://pic.cnblogs.com/avatar/675542/20150612173854.png 'hanzichi')
参考式:
![avater][1] [1]: http://pic.cnblogs.com/avatar/675542/20150612173854.png 'hanzichi'
注:到目前为止, Markdown 还没有办法指定图片的宽高,如果你需要的话,你可以使用普通的 <img>
标签。
可以使用反斜杠 /
来插入一些在markdown语法中有其他意义的符号。
markdown支持的转义字符列表:
/ 反斜线 ` 反引号 * 星号 _ 底线 {} 花括号 [] 方括号 () 括弧 # 井字号 + 加号 - 减号 . 英文句点 ! 惊叹号
markdown不支持表格,可以用html语言进行书写。但要注意 HTML 标签内的 Markdown 表达式将不会被解析。