MARKDOWN语言简介
Markdown 语法的目标是:成为一种适用于网络的书写语言。特性是「易读易书写」。Markdown是一种书写语言,是大家约定好的一种书写有结构的文本文件的方式。而HTML,pdf 是发布的格式。
一份使用 Markdown 格式撰写的文件应该可以直接以纯文本发布,并且看起来不会像是由许多标签或是格式指令所构成。
Markdown的设计目标是容易转化成html发布。所有在Markdown中的标记实际都被MD编辑器转化成html元素了。Markdown实质是简化易读易写的html书写语言,解释成html。MD和html是完全兼容的,可以在MD中加入html的标签。
Markdown有许多衍生版本,GFM(GitHub Flavored Markdown)是github的一个MD语言扩展,对程序员来说很有爱。GFM的介绍。GFM部分的有爱特性:(1)代码高亮(2)任务列表(3)自动URL链接。
MARKDOWN编辑器
首先,Markdown文件就是文本文件,可以在任何文本编辑器中编辑。专业的Markdown编辑器的作用有(1)可以转换成html,html又可以转换成pdf——即可以转换成发布格式。(2)在线发布、协同编辑。(3)实时预览、工具栏。
编辑器 | stackedit插件 | https://stackedit.io/ | http://dillinger.io |
---|---|---|---|
需要特定的浏览器 | chrome | 不需要 | 不需要 |
离线使用 | √ | × | × |
快捷工具栏 | √ | √ | × |
导航栏 | √ | √ | × |
其他MD编辑器:简书(在线)、Made插件(不更新了)、Win Mac和Lin都有自己一些编辑器。还是用在线的,或者chrome插件,持续更新支持最新语法的。Ps.听说vim+vim插件+chrome+chrome插件,用起来也不错。
选用stackedit挺好的,不过它的离线使用很囧,一定要先在线下载好了所有文件(js之类)才能离线,如果想真正的离线使用也可以下载stackedit的开源源码,打开index.html 使用。
MARKDOWN语法
基本语法
主要语法很简单,但是有些琐碎和不常见的语法,如嵌套引用>>不需要特别记忆,到时候看到或者想到需要用的时候再查吧。只管主要语法。不过,和html5一样,真正的语法其实是编辑器定义的。
一般提供Markdown语言转义的编辑器或者网站都会提供语法说明,那是最准确的参考资料。
段落
- 什么不标记自然成为段落,即正文。一个段落是由一个或多个连续的行构成,段落间靠一个或以上视觉上的空行划分。
- 一般的段落不应该用空格或制表符缩进。所以一个空行就可以分区段落。
换行
结尾两个空格强制换行。
在文本中输入的换行会从最终生成的结果中删除,浏览器会根据可用空间自动换行。
标题
-
# 标题名
间隔一个空格,另外一种方式
一级标题名
=========
二级标题名
----------
- n个#表示n级标题,字号逐级降低。共6级。两种方式可以兼容,对于简单文档来说两级标题已经够了。而且横线的方式比较易读。任何数量的 = 和 - 都可以有效果
列表
- 无序列表 -或 + 或 *
有序列表 1. - 为了避免出现歧义,当写「1986. 哈哈哈」 这样的行需要加入转义标识。「1986\.
哈哈哈」
链接和图片
-
[链接说明](URL
)
![图片说明](URL)
链接和图片都可以放在文章最后,相当于引用。
[链接文字]\[链接引用标签]
\[链接引用标签]: 链接地址 "链接标题"
- 自动链接
<URL>
也会生成直接的地址
引用
- >引用内容
或者
>引用
>内容 - 可以选择只在开头加一个。也可以在每行前面都加一个,效果是一样的。
特殊字体
斜体表示强调 *文本*
粗体表示特殊强调 **文本**
粗斜体表示特别强调 ***文本***
横穿 ~~文本~~
代码
`行内短代码`
```语言
代码块
``````
####水平线
参考资料:
[中文简单MD语法,简书](http://jianshu.io/p/q81RER)
[另外一份中文的MD语法,MD中文wikipedia](http://zh.wikipedia.org/zh-cn/Markdown)
[一份英文的语法表单,有例子,准确清楚](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet)
[貌似是官方文档的中译版本,有点过时](http://wowubuntu.com/markdown/)
[这是官方文档,格式好难读,没看](http://daringfireball.net/projects/markdown/syntax)