markdown 入门

# markdown quickstart
---
[TOC]

---

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

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

##2.markdown 快速入门语法

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

###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)