折腾不止
Logo
折腾不止

Markdown 快速入门

经过认真的考虑,我最终还是选择 Ghost 来搭建博客,而没有选择当前最热门的程序—— WordPress 。原因当然是多方面的,但其中一个很重要的因素是 Ghost 支持 Markdown 语法,能够提供极佳的写作体验。

本文实际上是 Ghost 系统自动发布的 Markdown 上手指南,每个新建立的 Ghost 博客都会自动生成这么一篇文章,用于指导新用户使用 Markdown 语法。我觉得原文存在一些不足,于是做了一些补充和修改(相当于重写了)。


一、什么是 Markdown ?

Markdown 是一种轻量级标记语言,创始人约翰·格鲁伯(John Gruber)。

轻量级标记语言(Lightweight Markup Language)是一类用简单句法描述简单格式的文本语言。轻量级标记语言作为一种标记语言,它的语法简单,可方便地使用简单的文本编辑器输入,原生格式接近自然语言。

通俗的说,Markdown 就是一种简化的书写格式。 Markdown 有很多优点,使得它正在被越来越多的写作爱好者和撰稿者采用。

  • 易读。 Markdown 语法设计的目的就是为了易读,相比之下 HTML 标签则让 HTML 文档包含太多与内容无关的噪音。如果读者不熟悉 HTML 语法,就很难直接阅读 HTML 的源文件,但是阅读 Markdown 文档则非常容易。
  • 易用。 Markdown 的语法非常简单。常用的标记符号不超过十个,其学习成本很低,通常只需要几分钟就能掌握,而且一旦掌握,将一劳永逸。
  • 纯文本。 Markdown 就是纯文本,所有人都能打开。Markdown 文稿不会因为未来软件升级而产生不同版本之间的兼容问题,不会像 Word 那样因版本问题可能导致格式错误。

因此,在使用 Markdown 进行写作时,我们可以更多的专注文字内容本身,而更少的关注排版样式。当文稿完成之后,它同样可以具有非常美观的样式,例如:本文就是使用 Markdown 语法撰写的。此外,文稿也可以很容易的被导出为 HTML、PDF 和 .md 等文件。关于 Markdown 的优点,还可以参阅如下文章:

从一个科研工作者的角度看, Markdown 语法也同样适合撰写学术论文。


二、Markdown 语法

Markdown 语法非常简单,普通人随便花费几分钟时间便能掌握。以下介绍都包含示例,代码框内为Markdown 语法,其下方为输出的格式效果。

2.1 标题

使用一个或者多个#来定义文档中的标题和小标题:

# 这是一级标题
#### 这是四级标题

这是一级标题

这是四级标题

注:第几级标题就用几个#

2.2 强调

在文本前后各使用一个*来定义斜体:

*我是斜体*

我是斜体

在文本前后各使用两个*来定义加粗:

**我是粗体**

我是粗体

在文本前后各使用三个*来定义斜体加粗:

***我是斜体加粗***

我是斜体加粗

2.3 列表

在段首使用*来定义无序列表:

* Item number one
* Item number two
  • Item number one
  • Item number two

在段首使用<数字>.来定义有序列表:

1. Remember to buy some milk
2. Drink the milk
3. Tweet that I remembered to buy the milk, and drank it
  1. Remember to buy some milk
  2. Drink the milk
  3. Tweet that I remembered to buy the milk, and drank it

2.4 链接

可以使用直接粘贴页面 URL的方式 :

http://www.ztever.com

http://www.ztever.com

也可以使用[文本](链接)自定义链接文本:

[折腾不止](http://www.ztever.com)

折腾不止

2.5 图片

使用![文本](链接)

![The Ghost Logo](http://static.ghostchina.com/image/3/fe/34a9831916be9db1381ecb320491e.png)

The Ghost Logo

2.6 引用

在段首使用>来定义引用的内容:

> Wisdomous - it's definitely a word.

Wisdomous - it's definitely a word.

2.7 代码

行内代码:

 `<code>`

<code>

大段代码时,在代码前加 4 个空格:

.awesome-thing {
    display: block;
    width: 100%;
}

2.8 分割线

在任一新行输入 3 个或更多的短横线(减号)---

---

2.9 高级用法

Markdown 还可以直接书写 HTML 代码,例如:

<input type="text" placeholder="这是个输入框!" />

2.10 快捷键

最常用的 Markdown 语法都对应了快捷键,能简化输入:

markdown-shortcuts


掌握了上面这些基本的语法,应付日常写作就绰绰有余了。欲了解更多的语法,可参考官方文档: