Markdown 新手指南

概述

认识 Markdown

Markdown是一种用来写作的轻量级【标记语言】，它通过使用一些符号组成的标记来实现像Word那样排版。 Markdown的目的是实现【易读易写】，无论如何，可读性，是最重要的。

Markdown 的优点

• 让我们专注于内容，而不是排版样式。
• 纯文本带来的超强的兼容性，所有文本编辑器都能打开。
• 格式转换方便，能够轻松转换为pdf，html等。
• 语法简单，学习成本低。

Markdown 的误区

We believe that writing is about content, about what you want to say – not about fancy formatting. 我们坚信写作写的是内容，所思所想，而不是花样格式。–Ulysses for Mac

语法

特殊符号

Markdown是通过精挑细选的一些符号组成标记来实现内容的排版的，主要使用的了：

我们可以通过反斜杠来插入普通的符号，也可以通过反斜杠来插入一些语法中有其他意义的符号。例如用*星号加在文字旁边的方式来做出强调的效果。

区块元素

标题

这是最常用的格式，Markdown支持两种标题的语法，类 Setext 和 类 atx 形式。 类 Setext 形式是用底线的形式，利用 “=” （最高阶标题）和 “-” （第二阶标题），例如：

可以使用数量大于2个的 “=” 和 “-” 来实现一阶标题和二阶标题。

类 Atx 形式则是在行首插入1-6个 “#” ,对应标题1-6阶，例如

你可以像这样选择性的闭合类 Atx 样式的标题，行尾 “#” 数量是没有任何意义的，纯粹是美观用。

区块引用

Markdown 标记区块引用用的是 “>” 来引用，例如这样：

你也可以这样：

你还可以这样：

当然，还能这样：

列表

Markdown 支持有序列表和无序列表。

无序列表通过 “*” , “+” , “-” 座位标记符号,例如：

有序列表则使用数字链接英文句号，例如：

很重要的一点是，不论你在列表标记上使用的数字为几都不影响HTML输出。

代码区块

和程序相关的写作，通常会有已经排版好的代码区块，我们不希望代码也和文章一样去排版，而是希望它按照原来的样子显示，那么我们就希望用Markdown建立代码区块。
Markdown建立代码区块很简单，你可以简单缩进4个空格或者1个制表符，例如：

建立代码区块的4中方法中，4个空格和一个制表符代码区块会一直持续到没有缩进的那一行或者文件结尾。

分隔线

我们可以在一行中通过用三个以上的”*”,”-“,”_”来建立一个分隔线，行内不能有除了空格以外的东西，下面是三种不同写法建立的分隔线：

分隔线要注意的地方是减号分隔线需要和上面一行间隔一行，不然会把上面那行定义为二阶标题。

区段元素

链接

Markdown 支持两种形式的链接语法：行内式与参考式。通过”[]”方括号来标记。行内式链接只需要在方括号后面加入圆括号并插入网址即可，如果你还想加入链接的 title 文字，只需要在方括号中 在链接地址后加入一个空格在加入””把 title 文字包起来即可，例如：

参考式链接是在链接文字的方括号之后再接一个方括号，第二个方括号里面放的是链接的标记，我们只需要在文件的任意位置把标记定义出来就行了，例如：

我们可以看的出来无论是标记何处定义，标记都是有效的，并且我们定义标记时候定义 title 可以采取 双引号，圆括号都是可以的。
请注意： Markdown.p1 1.0.1 会忽略单引号包起来的链接 title ，所以我介绍的时候没有介绍单引号。
隐式链接标记功能可以让我们省去定义链接标记，例如：

这样都是可以的。

图片

Markdown 插入图片采取的是和链接很相似的语法来标记图片的，同样也是允许两种样式：行内式和参考式。都是在链接的前面添加一个”!”标识即可，存在”!”的为图片，不存在为链接，例如：

我们写博文的时候经常要用的图片；推荐：事先通过我们博客的多媒体把图片上传到我们博客，到时候在文章通过图片标签把链接加上即可；也可以直接使用我们编辑博文的编辑器上方的 “Add Media” 来添加图片。另外图片的命名需要注意，最好是图片所代表的意义，可为拼音可为英文，别直接用QQ截图xxxx的。我们上传的图片生成的链接是有规律的，如果没有命名重复的，一个批次上传的链接只有文件名不同，其他的都是一致的。

强调

Markdown 使用”*”星号和”_”底线来座位标记强调字词的符号,被一个”*”或者一个”_”包起来的字词会变成斜体，被两个”*”或者两个”_”包起来的字词会被加粗，例如：

如果你想在文字前后插入普通的星号或者底线，你可以用反斜线：

代码

如果要在行内添加代码，我们可以用”"把代码包起来，例如：

我要输出代码：`alert(ab);`。 我要输出代码：``alert(a`b);``。

1 2 3 4

我要输出代码：`alert(ab);`。   我要输出代码：``alert(a`b);``。


请注意：三个"“可以形成代码区块，标准的markdown是不支持的，GFM才支持的。
注意：我们博客暂时不支持行内添加代码标签的使用。

本地撰写工具

以下工具我只用过 HarooPad，小组其他使用 Windows 系统的成员用的 是 markdownpad2。

Mac 和 Linux 的 markdown 本地撰写工具，如有不好用的，请告知我，我从列表中去掉。

Windows

• markdownpad2
• HarooPad

Mac
* Byword
* Mou
* MacDown
* Typora

Linux
* ReText