Markdown语法说明(一)

一、与HTML的关系:

1、HTML是一种发布的格式,Markdown是一种书写的格式。

2、HTML块级元素<div>、<pre>、<table>、<p>等之间写入Markdown格式语法将不会被解析。

3、HTML行级元素<span>、<cite>、<del>之间的Markdown语法是有效的。

二、特殊字符的格式转换:

在HTML中要写出“<”和“&”字符就要在代码中使用其实体,例如“&lt;”和“&amp;”,而在Markdown语法中书写时可以直接写,例如:

(1)要在文档插入一个版权符号©,可以写&copy;Markdown将会将其保留不变。

(2)若写AT&T,Markdown会将其转化为AT&amp;T

三、段落和换行:

(1)一个Markdown前后要一个以上的空行(一行中只包括空格和制表符也被视为一个空行),普通段落不用空格和制表符来进行缩进。

(2)Markdown中插入<br>,要先按两个空格再回车。

四、标题:

(1)类Setext形式:(用底线的形式,“=”最高阶标题,“-”第二阶标题)

eg:

This is H1

========

This is H2

---------

(2)类Atx形式在行首插入1到6个#:

eg:

#这是H1

##这是H2

五、区块引用Blockqutes:

(1)语法格式:在每行的最前面加上“>”.

(2)也允许一个段落上只在开头加上一个“>”。

(3)区块引用“>”可以嵌套,只要根据层次体现加不同数量的“>”:

eg:

>This is the firset level of quoting

>

>>This is nested blockquote

>

>>Back to the first level

(4)引用区块内可以有其他Markdown语法,包括标题,列表,代码区块等。

六、列表:

(1)无序列表(使用“*”、“+”、“-”来标记)

(2)有序列表(使用数字接一个英文句号)

eg:

1.Red

2.Blue

(3)如果列表项目间用空行分开,在输出HTML时,Markdown就会将项目内容用<p>标签包裹起来:

eg:

*Bird

 

*Magic

转成HTML:

<ul>

<li><p>Bird</p></li>

<li><p>Magic</p></li>

<ul>

(4)如果要在列表项目中放入引用“>”就需要缩进:

eg:

*A list item with a blockquote

>This is a blockquote

>inside a list item

(5)如果要在列表项目中放入代码区块,就需要缩进两次,也就是8个空格或者两个制表符。

(6)如果就想写出1968.What’s  a great season 这样的效果,而并不是想要写一个有序列表项,就要加入转义符号“\”:

eg:

1968\. What’s  a great season

七、代码区块:

(1)在Markdown建立语法区块很简单,只需要4个空格或者1个制表符,Markdown会用<pre>和<code>标签将代码区块包裹起来。代码块会一直持续到没有缩进的那一行(或是文件结尾)。

(2)代码块中任何特殊符号都会原样显示。

八、分割线:

可以在一行中使用三个以上的星号、减号、底线来建立分割线,行内不能有其他东西,但是能有空格。

九、链接:

支持两种形式的链接语法:行内式和参考式

feihu分享到:

          

You may also like...

Scroll Up