MarkDown语法

MarkDown对于我们的影响是重大的,简单的语法结构可以使我们快速的写出一篇简洁,大方的博客.对于MarkDown语法的熟悉就成了必要的了！！—>Newt

Preface

可读性，无论如何，都是最重要的.一份使用 Markdown 格式撰写的文件可以直接以纯文本发布.MarkDown语法说明(网络查找部分):更多详情请点我.掌握MarkDown语法可以使我们更加高效的写我们的文章,语法的目标也是(成为一种适用于网络的书写语法).

Advantage

兼容 HTML
区块元素
区段元素
其它

Compatibility

兼容HTML

MarkDwon兼容HTML标签,在文章里面可以直接使用HTML撰写,不需要标注这是HTML/MarkDown,只要直接加标签就可以了.简单的例子:

newt的一个段落

<table>

    <tr>

        <td>Foo</td>

    </tr>

</table>

这是另一个普通段落。

特殊字符

特殊字符在很多语言中都有自己的特殊处理,在HTML中的< 和 &,<符号是用于起始标签,&用于标记HTML实体,HTML中©可以写成 © 也可以直接输入©HTML中 < 和 & 都需要转码,但是MarkDwon不必,输入&和&都显示 &, < 也一样 4 < 5 后面要加上空格,否则会当其实标签使用.4<5 输出的字符码是<,不需要考虑转码问题.

罗列一些字符码:

显示结果        描述        实体名称        实体编号    

space        空格        &nbsp;       &#160;

<            小于号        &lt;       &#60;    

>           大于号     &gt;       &#62;

&            与号        &amp;        &#38;    

"            引号        &quot;        &#34;    

|            单引        &apos;        &#39;

block element

段落和换行

一个MarkDown段落的前后要有一个以上的空行,段落不需要使用空格/制表符来进行缩进.
标题
1. Setext:使用=(最高阶标题)或者-(第二阶标题)表示两阶标题,符号数量建议3个以上(任何数量的=/-都会有效果0).
2. atx:插入1~6个#,对应标题的1到6阶(也可以闭合性的结束标签,但是真正决定阶数的是行首的#).
```
This is an H1
=============

This is an H2
-------------

# 这是 H1

## 这是 H2  ##

###### 这是 H6  ######
```

区块引用

Markdown 标记区块引用是使用类似 email 中用 > 的引用方式。如果你还熟悉在 email 信件中的引言部分，你就知道怎么在 Markdown 文件中建立一个区块引用，那会看起来像是你自己先断好行，然后在每行的最前面加上 > ：
```
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
> consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
```

列表
1. 无序列表
  
  使用星号、加号或是减号作为列表标记
```
*    我是无序列表1
*    我是无序列表2
```
2. 有序列表
  
  使用数字+英文句点
```
1.  我是有序列表1
2.    我是有序列表2
```
代码区块
1. 和程序相关的写作或是标签语言原始码通常会有已经排版好的代码区块，通常这些区块我们并不希望它以一般段落文件的方式去排版，而是照原来的样子显示，Markdown 会用 <pre> 和 <code> 标签来把代码区块包起来。
2. 要在 Markdown 中建立代码区块很简单，只要简单地缩进 4 个空格或是 1 个制表符就可以
```
这是一个普通段落：

 这是一个代码区块。
```
 Markdown 会转换成：
```
这是一个普通段落：

<pre><code>这是一个代码区块。
</code></pre>
```
3. 在代码区块里面， & 、 < 和 > 会自动转成 HTML 实体,这样可以让你非常容易使用Markdown插入范例用的 HTML 原始码[只需要复制贴上，再加上缩进就可以了，剩下的 Markdown 都会帮你处理
4. 代码区块中,一般的MarkDown语法不会被转换,像是*便是自己,这标识你可以很容易的以MarkDown语法撰写MarkDown语法相关的文件.

分隔线

你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线，行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线
```
* * *

***

*****

- - -

---------------------------------------
```

Segment element

链接
1. 行内式
  
  在方块括号后面紧接着圆括号并插入网址链接即可，如果你还想要加上链接的 title 文字，只要在网址后面，用双引号把 title 文字包起来即可
```
[My Blog](http://www.newt.fun)
```
2. 参考式
  
  在链接文字的括号后面再接上另一个方括号，而在第二个方括号里面要填入用以辨识链接的标记
```
[My Blog][blogLink]
[blogLink]: http://www.newt.fun  "梦在这里腐了朽剩流泪"
```
  链接内容定义的形式为：
- 方括号（前面可以选择性地加上至多三个空格来缩进），里面输入链接文字
- 接着一个冒号
- 接着一个以上的空格或制表符
- 接着链接的网址
- 选择性地接着 title 内容，可以用单引号、双引号或是括弧包着

强调

Markdown 使用星号 * 和底线_作为标记强调字词的符号，被 * 或 _ 包围的字词会被转成用  标签包围，用两个 * 或 _ 包起来的话，则会被转成 

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

会转成:

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

代码

如果要标记一小段行内代码，你可以用反引号把它包起来’ ` ‘.
```
Use the `printf()` function.
```
会转成:
```
Use the <code>printf()</code> function.
```
图片
1. 行内式
  - 一个惊叹号 !
  - 接着一个方括号，里面放上图片的替代文字
  - 接着一个普通括号，里面放上图片的网址，最后还可以用引号包住并加上选择性的 ‘title’ 文字。
```
![blog](/path/to/img.jpg)

![blog](/path/to/img.jpg "title")
```
2. 参考式
  - 一个惊叹号 !
  - 接着一个方括号，里面放上图片的替代文字
  - 接着一个方括号,里面放着图片参考的名称，图片参考的定义方式则和连结参考一样：
```
![blog][tag]

[tag]: url/to/image  "This is My Blog"
```

Other

反斜杠

Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号，例如：如果你想要用星号加在文字旁边的方式来做出强调效果（但不用  标签），你可以在星号的前面加上反斜杠：
```
\*This is My Blog\*
```
Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号：
```
\ 反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号
```
自动链接

Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱，只要是用方括号包起来， Markdown 就会自动把它转成链接。一般网址的链接文字就和链接地址一样.
```
<http://15611700291@163.com/>
```
会转成:
```
<a href="http://15611700291@163.com/">http://example.com/</a>
```

engage in chitchat

今天天气阴,但是万里晴空,心情惆怅.这是半个多月后的一次更新,感觉有点对不起自己.

MarkDown语法

Preface

Advantage

Compatibility

block element

Segment element

Other

engage in chitchat

TAGS