markdown 入门

# markdown quickstart
---
[TOC]

---

## 1.introduction
  markdown的最初设计是让人专一写做，又让输出内容易于阅读。它适用于典型应用场景，如写博客，说明文档等一切要求书写内容大且快速造成易于阅读的文档。
 
  对比HTML,wiki, Markdown是一种轻量级的标记语言，语法简单，能够排出简洁的表现界面,适用于网络的书写语言，且支持表格，代码块，目录，连接等
 
 
###markdown优势
- 纯文本
- 快速格式化
- 书写简单，易学易懂，且源码易阅读
- 利用导出其它流行格式html,pdf等
- 扩展工具免费且丰富

###markdown缺点
- 不支持更丰富的格式化
- 未标准化

##2.markdown 快速入门语法

###1. heading
```
  #h1         <h1></h1>
  ##h2        <h2></h2>
  ###h3       <h3></h3>  
```

###2. bold,Italic & strikethrough
*Italic*  
**bold**  
***bold&Italic***  
~~删除线~~

###3. list
也能够缩进，最多 3 个空格，项目标记后面则必定要接着至少一个空格或制表符
列表支持嵌套

- unorder list1
- unorder list2
- unorder list3
* unorder list4
* unorder list5
+ unorder list6



1. order list 1
2. order list 2
3. order list 3

###5. table
header1 | header2 | header3
---     |-------: |:---:
foo     | foo     | foo
bar     | bar     | bar
baz     | baz     | baz

| Tables        | Are           | Cool  |
| :-------------: |:-------------:| -----:|
| col 3 is      | right-aligned | $1600 |
| col 2 is      | centered      |   $12 |
| zebra stripes | are neat      |    $1 |


### 6. todo list
- []  todo1
- [x]  todo2
- [x]  todo3


###7. blockquote
 
```
<blockquote>
it can be used to highlight your code
使用多个>，能够将<blockquote>嵌套，且<blockquote>内能够使用其它markdown语法
line 1
line 2
line 3
```
   
   
> This is the first level of quoting.
>
> `inline code`
> `sum = b + c`   <code> inline code  </code>    行内代码
> `mkdir tickets`  then ` cd tickets`
>  header line test
>
> - unorder list1
> - unorder list2
> > This is nested blockquote. 引用嵌套
>
> Back to the first level.

###8. other
   --- 分页线  <hr />
   
   空白行表示另起一个段落
   
   <hr>
   
   行尾两个以上空格+Enter   <br /> markdown段内强制换行  
 
###9.兼容HTML
1. 不在 Markdown 涵盖范围以内的标签，均可以直接在文档里面用 HTML 撰写
2. 一些HTML的区块元素，如`<div><table><pre><p>`等标签,必须在先后加上空行与其它内容区隔开
3. HTML的开始标签与结尾标签不能用制表符或空格来缩进
4. 在 HTML 区块标签间的 Markdown 格式语法将不会被处理
5. HTML 的区段（行内）标签如 `<span>、<cite>、<del> `能够在 Markdown 的段落、列表或是标题里随意使用

<p>Here is an example of AppleScript:</p>

###10.特殊字符自动转换< &　\
HTML中的两个字符(< &)须要特别处理，<用于标签，&用于标记HTML实体。 markdown能够让人天然地书写字符，它会根据语境自动决定是否转换：  
markdown code 范围内，不管是行内仍是区块，< 和 ＆ 都必定会被转换成 HTML 实体
markdown使用\来转义，表示文本中markdown符号




## markdown editor
[Mahua](http://mahua.jser.me/)
[maxiang](https://maxiang.io/)
[mou](http://25.io/mou/)
[gedit-markdown](https://github.com/jpfleury/gedit-markdown)
[markdown 语法说明](http://wowubuntu.com/markdown/index.html#autoescape)