What?

Markdown是一种轻量级的 「标记语言」,它的优点很多,目前也被越来越多的写作爱好者,撰稿者广泛使用。看到这里请不要被「标记」、「语言」所迷惑, Markdown的语法十分简单。常用的标记符号也不超过十个,这种相对于更为复杂的 HTML标记语言来说, Markdown是十分轻量的,学习成本也不需要太多,且一旦熟悉这种语法规则,会有一劳永逸的效果。

Why?

既然这种标记语言最终还要转换为 HTML文档格式,那么为什么我们还要使用它呢?有啥好处?

  1. 专注于你写作的内容本身,而不是排版样式。
  2. 可以导出 HTML、PDF 和本身的 .md 文件。
  3. 纯文本内容,兼容所有的文本编辑器与字处理软件。
  4. 随时修改你的文章版本,不必像字处理软件生成若干文件版本导致混乱。
  5. 可读、直观、学习成本低。

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语法:

    - 列表文本前使用 [减号+空格]+ 列表文本前使用 [加号+空格]* 列表文本前使用 [星号+空格]
    登录后复制

普通有序列表效果:

  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')
登录后复制

参考文献

  1. Markdown 编辑器语法指南
  2. Markdown——入门指南

09-13 05:46