What?
Markdown是一种轻量级的 「标记语言」,它的优点很多,目前也被越来越多的写作爱好者,撰稿者广泛使用。看到这里请不要被「标记」、「语言」所迷惑, Markdown的语法十分简单。常用的标记符号也不超过十个,这种相对于更为复杂的 HTML标记语言来说, Markdown是十分轻量的,学习成本也不需要太多,且一旦熟悉这种语法规则,会有一劳永逸的效果。
Why?
既然这种标记语言最终还要转换为 HTML文档格式,那么为什么我们还要使用它呢?有啥好处?
- 专注于你写作的内容本身,而不是排版样式。
- 可以导出 HTML、PDF 和本身的 .md 文件。
- 纯文本内容,兼容所有的文本编辑器与字处理软件。
- 随时修改你的文章版本,不必像字处理软件生成若干文件版本导致混乱。
- 可读、直观、学习成本低。
How?
基本技巧
标题
文章内容较多时,可以用标题分段:效果:
标题1
标题2
标题3
标题4
标题5
标题6语法:
# 标题1## 标题2### 标题3#### 标题4##### 标题5###### 标题6
粗体和斜体
效果:
斜体文本
粗体文本
粗斜体文本
语法:
*斜体文本* 或者 _斜体文本_**粗体文本** 或者 __粗体文本__***粗斜体文本*** 或者 ___粗斜体文本___
链接
常用链接方法
效果:
文字链接 Reeoo’s Blog
网址链接 http://reeoo.me
语法:
文字链接 [链接名称](http://链接网址)网址链接
高级链接技巧
这个链接用 me作为网址变量 [ReeooMe][me]
这个链接用 co作为网址变量 [ReeooCo][co]
然后在文档的结尾为变量赋值(网址)
[me]: http://reeoo.me/[co]: http://reeoo.co/
效果:
ReeooMe
ReeooCo列表
普通无序列表效果:
- 列表项1
- 列表项2
- 列表项3语法:
- 列表文本前使用 [减号+空格]+ 列表文本前使用 [加号+空格]* 列表文本前使用 [星号+空格]
登录后复制
普通有序列表效果:
- 列表前使用 [数字+空格]
- 我们会自动帮你添加数字
- 不用担心数字不对,显示的时候我们会自动把这行的 7 纠正为 3
语法:
1. 列表前使用 [数字+空格]2. 我们会自动帮你添加数字7. 不用担心数字不对,显示的时候我们会自动把这行的 7 纠正为 3
引用
普通引用
> 引用文本前使用 [大于号+空格]> 折行可以不加,新起一行都要加上哦
效果:
引用文本前使用 [大于号+空格]折行可以不加,新起一行都要加上哦
引用里嵌套引用
语法:
> 最外层引用> > 多一个 > 嵌套一层引用> > > 可以嵌套很多层
效果:
最外层引用
多一个 > 嵌套一层引用
可以嵌套很多层
引用里嵌套列表
语法:
> - 这是引用里嵌套的一个列表> - 还可以有子列表> * 子列表需要从 - 之后延后四个空格开始
效果:
- 这是引用里嵌套的一个列表
- 还可以有子列表
- 子列表需要从 - 之后延后四个空格开始
图片
跟链接的方法区别在于前面加了个感叹号 !,这样是不是觉得好记多了呢?
语法: ![图片名称](http://图片网址)当然,你也可以像网址那样对图片网址使用变量
这个链接用 me作为网址变量 [Reeoo's Blog][me].
然后在文档的结尾位变量赋值(网址)
[me]: http://img.reeoo.me/compass/add.jpg
分隔符
如果你有写分割线的习惯,可以新起一行输入三个减号-。当前后都有段落时,请空出一行:
写法:
前面的段落---后面的段落
效果:前面的段落
后面的段落
表格
表格是我觉得 Markdown比较累人的地方,例子如下:
| Tables | Are | Cool ||:------------- |:-------------:| -----:|| col 3 is | right-aligned | $1600 || col 2 is | centered | $12 || zebra stripes | are neat | $1 |
Tables | Are | Cool |
---|---|---|
col 3 is | right-aligned | $1600 |
col 2 is | centered | $12 |
zebra stripes | are neat | $1 |
代码
如果你只想高亮语句中的某个函数名或关键字,可以使用 `function_name()` 实现( function_name())
通常编辑器根据代码片段适配合适的高亮方法,但你也可以用 ``` 包裹一段代码,并指定一种语言
$(function () { console.log('reeoo.me');});
支持的语言: actionscript, apache, bash, clojure, cmake, coffeescript, cpp, cs, css, d, delphi, django, erlang, go, haskell, html, http, ini, java, javascript, json, lisp, lua, markdown, matlab, nginx, objectivec, perl, php, python, r, ruby, scala, smalltalk, sql, tex, vbscript, xml也可以使用 4 空格缩进,再贴上代码,实现相同的的效果
console.log('reeoo.me')
参考文献
- Markdown 编辑器语法指南
- Markdown——入门指南