Markdown使用详解

MarkDown介绍

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

Markdown 是一种用来写作的轻量级「标记语言」，它用简洁的语法代替排版，而不像一般我们用的字处理软件 Word 或 Pages 有大量的排版、字体设置。它使我们专心于码字，用「标记」语法，来代替常见的排版格式。例如此文从内容到格式，甚至插图，键盘就可以通通搞定了。

现在，支持 Markdown 语法的编辑器有很多，包括很多网站（例如 CSDN 博客、CODE CHINA）都支持了 Markdown 格式。Markdown 从写作到完成，导出格式随心所欲，你可以导出 HTML 格式的文件用来网站发布，也可以十分方便的导出 PDF 格式。

使用 Markdown 的优点

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

使用 Markdown 的误区

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

Markdown 旨在简洁、高效，也由于 Markdown 的易读易写，人们用不同的编程语言实现了多个版本的解析器和生成器。这就导致了目前不同的 Markdown 工具集成了不同的功能（基础功能大致相同），例如流程图与时序图，复杂表格与复杂公式的呈现，比如 GFM Markdown 就支持使用 Mermaid 生成图表和流程图。

段落及强调

在 Markdown 中，段落是由一个以上相连接的行句组成，而一个以上的空行则会切分出不同的段落，一般的段落不需要用空白或换行缩排。

空行的定义是显示上看起来像是空行，便会被视为空行。

比如，若某一行只包含空白 和 tab`` ，则该行也会被视为空行

段落

「一个以上相连接的行句组成」这句话其实暗示了 Markdown 允许段落内的强迫换行，这个特性和其他大部分的 text-to-HTML 格式不一样（包括 MovableType 的「Convert Line Breaks」选项），其它的格式会把每个换行都转成 <br /> 标签。

这也就意味着在 Markdown 中，如果需要把一段内容当做段落来显示，则需要保证该段内容上方及下方至少各有一个空行，比如:

这里是段落一
这里是段落二

这段文字在 Markdown 中就会被显示成一行：

这里是段落一

这里是段落二

当然，你也可以在段落后面使用一个空行来表示重新开始一个段落，比如：

这里是段落一

这里是段落二

这里是段落一

这里是段落二

此外，你也可以选择在第一行的末尾添加 <br> 进行换行，比如：

这里是段落一<br>
这里是段落二

就会显示成两段内容：

这里是段落一

这里是段落二

强调

Markdown 使用星号 * 和下划线 - 作为标记强调字词的符号。

*这里是斜体内容1*

_这里是斜体内容2_

会显示为

这里是斜体内容1

这里是斜体内容2

<em>这里是斜体内容1</em>
<em>这里是斜体内容2</em>

需要注意的是：

1. 用什么符号开启标签，就要用什么符号结束
2. * 和 _ 两边都有空白的话，它们就只会被当成普通的符号
3. 如果要在文字前后直接插入普通的星号或下划线，可以用反斜杠\* \_

粗体

用两个 * 或 _ 包起来的话，则会被转成 ，例如：

**这里是粗体内容1**

__这里是粗体内容2__

会显示为

这里是粗体内容1

这里是粗体内容2

<strong>这里是斜体内容1</strong>

<strong>这里是斜体内容2</strong>

会显示为

这里是斜体内容1

这里是斜体内容2

删除线

你还可以使用两个 ~ 来给内容加上删除线，例如：

~~这个内容是被删掉的~~

会显示为

这个内容是被删掉的

或

<del>这个内容是被删掉的</del>

会显示为

这个内容是被删掉的

Hello,world

标题

Markdown 支持两种标题的语法，Setext 和 atx 形式。

Setext 形式标题

Setext 形式是用底线的形式，利用 = （一级标题）和 - （二级标题），例如：

标题1
=====

标题2
-------

会显示为:

标题1

标题2

或者

<h1>标题1</h1>

<h2>标题2</h2>

注意，Setext 形式的标题至少需要3个以上的 = 或 _ 才可以正常显示为标题样式。

Atx 形式标题

Atx 形式则是在行首插入 1 到 6 个 #（最多支持 6 级标题） ，对应到标题 1 到 6 级，例如：

# 标题1

## 标题2

#### 标题4

###### 标题6

会显示为：

标题1

标题2

标题4

标题6

链接

Mark