本质
Markdown
markdown 是文本,写完之后保存成txt文件,需要用引擎(markdown引擎是用markdown写的)来转化成html才能在浏览器显示。比如官方页面:
markdown的源文件是:
推荐一个markdown编辑器,叫MarkdownPad(http://markdownpad.com/)。提供实时预览和常用的菜单操作。
基本语法
标题:
markdown支持两种风格语法Setext 和 atx
Setext 如下>>
H1: Hello
=
H2: Hello
-
无论“=” 和‘-’多少个,作用和一个是一样的
atx 如下>>
# This is an H1
## This is an H2
...
"#"个数表示标题级别,也可以将标签闭合起来,比如
# This is an H1 ###
左边的"#"个数决定文本的级别,右侧可以任意多个
块级引用:
markdown用">"来开始一段被引用的文本,比如
> This is a markdown text block
> Lazy dog jump over the grey fox
> Lazy dog jump over the grey fox
> Lazy dog jump over the grey fox
块级引用支持懒人写法,只在段落的第一行写一个">", 比如
> This is a markdown text block
Lazy dog jump over the grey fox
Lazy dog jump over the grey fox
Lazy dog jump over the grey fox
块级引用支持引用嵌套,左边“>”的个数表示嵌套的层数,比如
>This is a markdown text block
>> This is a markdown text block
块级引用中支持其他markdown标签,包括标题,列表,代码块
列表:
markdown支持有序和无序两种列表。有序的只支持数字序号,无序的支持"*", "+", "-"。在markdown里写有序刘表的序号是无意义的,它会重新排序,而无序列表不管用哪种符号,显示出来的多是黑点。比如
有序>>
1. First
1. Second
4. Third
显示出来的是
1. First
2. Second
3. Third
如果不想让markdown排序,则可以加反斜杠,比如
1\. First
1\. Second
4\. Third
无序>>
+ First
+ Second
+ Third
如果要在列表中用块级引用,则需要">"前回车换行,比如
+ First
> block goes here
+ Second
+ Third
代码块:
markdown中代码块,可以简单的用4个空格或者1个Tab缩进, 比如
sdfasdfas
asdfasd
asdfasdf>
<div class="asdfas">
2004 Foo Corpration
</div>
asdfasd
asdfasdf>
<div class="asdfas">
2004 Foo Corpration
</div>
在遇到第一个缩进的行时,代码块自动终止。在代码块中所有的特殊字符,比如< > &等都会转化成html实体 (
<
>
&)
如果需要在行内使用代码风格,则可以用"`"包围,即键盘上波浪线那个键。
水平分割线:
可以用连续的三个以上"*"或者"-",“*”符号之间最多保3个空格,“-”之间最多2个
链接:
markdown支持两种风格:行内,引用
行内>>
This is a [Link](http://g.cn "谷歌")
方括号中的是链接文本,括号中的两个参数,第一个是链接地址href,第二个是title,两者之间用空格隔开。
引用>>
This [LinkName][id] referrence-style link
[id]: http://g.cn
"谷歌"
[id]: http://g.cn
"谷歌"
这里的"id"相当于一个标识符,对应这个链接的信息,可以为任意字符(包括数字)。标识符用"[]"包围,后面跟链接的href, title。href和title之间用空格或者换行分开,title必须用双引号包围。标识符部分可以写在页面任意地方,不需要紧随[LinkName]。
标识符不区分大小写,比如
[link][a]
[link][A]都将引用
[a]
http://g.cn "谷歌"
如过有多个引用值,则取最后一个
比如
[a] http://g.cn "谷歌"
[A] http://baidu.com "百度"
链接将指向最后一个定义的地址。
如果标识符忘了写,则LinkName将作为标识符,比如
[Google][]
那么写链接信息时需要
[Google]:
http://g.cn "谷歌"
简单的链接可以用"<>"包围,比如
<http://g.cn>,它将产生一个<a href='http://g.cn'>http://g.cn</a>的链接
强调:
markdown中强调也有加粗(B)和倾斜(I),有两种方式。
倾斜用“*”或者“_”包围,加粗用“**”或者“__”
图片:
类似链接也有两种风格:行内,引用
行内>>
![图片alt文本](https://www.google.com.hk/images/nav_logo107.png "图片title")
引用>>
![图片alt文本][id]
这里的id标志符写法同链接的写法
[id]: https://www.google.com.hk/images/nav_logo107.png "图片title"