Markdown学习笔记，推荐stackedit编辑器
Markdown学习笔记
1.Markdown语言简介
Markdown 语法的目标是：成为一种适用于网络的书写语言。特性是「易读易书写」。Markdown是一种书写语言，是大家约定好的一种书写有结构的文本文件的方式。而HTML，pdf 是发布的格式。
一份使用 Markdown 格式撰写的文件应该可以直接以纯文本发布，并且看起来不会像是由许多标签或是格式指令所构成。
Markdown的设计目标是容易转化成html发布。所有在Markdown中的标记实际都被MD编辑器转化成html元素了。Markdown实质是简化易读易写的html书写语言，解释成html。MD和html是完全兼容的，可以在MD中加入html的标签。
Markdown有许多衍生版本，GFM（GitHubFlavored Markdown）是github的一个MD语言扩展，对程序员来说很有爱。GFM的介绍https://help.github.com/articles/github-flavored-markdown。GFM部分的有爱特性：（1）代码高亮（2）任务列表（3）自动URL链接。
2.Markdown编辑器
首先，Markdown文件就是文本文件，可以在任何文本编辑器中编辑。专业的Markdown编辑器的作用有（1）可以转换成html，html又可以转换成pdf——即可以转换成发布格式。（2）在线发布、协同编辑。（3）实时预览、工具栏。
| 编辑器 | stackedit插件 | Minimalist Markdown Editor插件 | ||
| 需要特定的浏览器 | 需要 | 不需要 | 不需要 | 需要 |
| 离线使用 | √ | %>_<% | %>_<% | √ |
| 快捷工具栏 | √ | √ | %>_<% | %>_<% |
| 支持导航 | √ | √ | %>_<% | %>_<% |
| 持续更新 | √ | √ | √ | √ |
| 是否支持GitHub Flavored Markdown | 支持table 支持自动链接 | 支持table 支持自动链接 | 支持~~囧~~ 即，囧 | 不支持 |
其他MD编辑器：Win Mac和Lin环境下都有自己一些编辑器。还有在线的，如简书（在线），或者chrome插件，如Made插件（不更新了）。Ps.听说vim+vim插件+chrome+chrome插件，用起来也不错。
选用stackedit挺好的，不过它的离线使用很囧，一定要先在线下载好了所有文件(js之类)才能离线，如果想真正的离线使用也可以下载stackedit的开源源码，打开index.html 使用，源码地址 https://github.com/benweet/stackedit。
3.Markdown语法
基本语法
主要语法很简单，但是有些琐碎和不常见的语法，如嵌套引用>>不需要特别记忆，到时候看到或者想到需要用的时候再查吧。只管主要语法。不过，和html5一样，真正的语法其实是编辑器定义的。
| 语法 | 如何标记 | 效果（还是要看编辑器和库的实现） |
| 段落 | 什么不标记自然成为段落，即正文。 一个段落是由一个或多个连续的行构成，段落间靠一个或以上视觉上的空行划分。 | 一般的段落不应该用空格或制表符缩进。 所以一个空行就可以分区段落。 |
| 换行 | 结尾两个空格强制换行。 在文本中输入的换行会从最终生成的结果中删除，浏览器会根据可用空间自动换行。 |
|
| 标题 | # 标题名 间隔一个空格，另外一种方式 一级标题名 ========== 二级标题名 ----------------- | n个#表示n级标题，字号逐级降低。共6级。 两种方式可以兼容，对于简单文档来说两级标题已经够了。而且横线的方式比较易读。
任何数量的 = 和 - 都可以有效果 |
| 列表 有序列表 | - 或 + 或 * 1. | 为了避免出现歧义，当写「1986. 条是***」这样的行需要加入转义标识。「1986\. 条是***」 |
| 链接 图片
自动链接 | [链接说明]（URL） ![]（URL） 链接和图片都可以放在文章最后，相当于引用 [链接文字][链接引用标签] [链接引用标签]: 链接地址 "链接标题" <URL>也会生成直接的地址 | 例子： ![alt text][logo]
[logo]: https://github.com/adam-p/markdown-here/raw/master/src/common/images/icon48.png "Logo Title Text 2" |
| 引用 | >引用内容
>引用 >内容 | 可以选择只在开头加一个。也可以在每行前面都加一个，效果是一样的。 |
| 斜体 粗体 粗斜体
横穿 | *文本* **文本** ***文本*** 用_文本_也可以，对于程序员来说不方便 ~~文本~~ | 表示强调 表示加重强调 表示特别强调 |
| 代码 | `行内短代码` ···语言 代码块 ··· | 反引号，也就是tab键上面那个符号 |
| 水平线 | --- *** ___ | 3个或以上 |
参考资料：
[中文简单MD语法，简书] http://jianshu.io/p/q81RER
[一份英文的语法表单，有例子，准确清楚] https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet
[貌似是官方文档的中译版本，有点过时] http://wowubuntu.com/markdown/
[这是官方文档，格式好难读，没看] http://daringfireball.net/projects/markdown/syntax
GFM
GFM的部分语法，如横穿等被吸收到新的SM中了。最支持GFM的当然是github，可惜不支持实时预览。当然了，其中还包括一些为github专门设计的语法，如表情之类的，这里就不做介绍，参考文献中有。
| 任务列表 | - [x] 任务描述 - [x] 任务描述 - [ ] 任务描述 | 显示类似todolist的小框，[x]和[ ]分别表示完成和未完成 |
| 语法高亮 | 代码会根据语言高亮显示 |
|
| 自动链接 | 不需要加<> | 自动识别URL并转化显示 |
| _失效 | _文本_不再表示强调 | 避免歧义 |
| 新的换行 | 换行符就是换行 | 不需要两个空格了 |
| 表格 | | Tables | Are | Cool | | ------------- |:-------------:| -----:| | col 3 is | right-aligned | $1600 | | col 2 is | centered | $12 | | zebra stripes | are neat | $1 |
Markdown | Less | Pretty --- | --- | --- *Still* | `renders` | **nicely** 1 | 2 | 3 | 首行自动强调显示 第二行表示居左/中/右格式
|
参考资料
[github help文件：GitHubFlavored Markdown] https://help.github.com/articles/github-flavored-markdown
[GFM和SM(StandardMarkdown)的区别，简书，中文] http://jianshu.io/p/cfPxyr
内联html
以后补充。