Markdown基本语法

---

一、Markdown简介

Markdown是一种轻量级的标记语言，创始人为约翰·格鲁伯（英语：John Gruber）。约翰·格鲁伯于2004年创造了Markdown语言，有相当大一部分语法是和亚伦·斯沃茨（Aaron Swartz）合作完成。

二、Markdown的优点

语法简单易学，常用的标记符号不超过十个，兼容所有的文本编辑器与字处理软件，可以导出 为HTML、PDF 和本身的 .md 文件。Markdown目前在很多网站被广泛使用，例如。

三、Markdown 基本语法总结

在中将默认编辑器设置为MarkDown编辑器，切换为预览模式就可以边输入边看到呈现效果了。

• 标题

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

一级标题

二级标题

this is an H1

This ia a H2

在MarkDown编辑器中的写法为：
一级标题
================
二级标题
-------------
This is a H1
================
This is a H2
---------------

(任何数量的 `=` 和 `-` 都可以有效果。)

类 Atx 形式则是在行首插入 1 到 6 个 # ，对应到标题 1 到 6 阶，例如：

H1 一级标题

H2二级标题

H3 三级标题

H4四级标题

H5五级标题

H6六级标题

在MarkDown编辑器中的写法为：
#H1 一级标题
##H2二级标题
###H3 三级标题
####H4四级标题
#####H5五级标题
######H6六级标题

---

• 插入图片：![]()

例如：[图片上传失败...(image-7149c3-1525536139655)]

在MarkDown编辑器中的写法为：
例如：![](https://zh.wikipedia.org/static/images/project-logos/zhwiki.png).

---

• 插入链接：[链接文字](链接地址)

例如: Markdown

在MarkDown编辑器中的写法为：
例如： [Markdown](http://zh.wikipedia.com/wiki/Markdown)

---

• 引用

  引用只需在被引内容段落开头加上右尖括号>即可。可以选择只在开头加一个或在每行前面都加一个，效果是一样的。
  引用可以嵌套。如果要在一个引用里插入一个引用，可以用两个>开头。依此类推，根据嵌套层次加相应数量的符号。

这是第一个引用。

这是一个嵌套引用。这是第二层引用的第一行。
这是第二行

外层引用的第三行。空行前面的>可有可没有。

---

• 列表

列表格式常用的有无序列表和有序列表两种，在 Markdown 中，只需在文字前面加上 星号、加号或是减号作为列表标记就可以表示无序列表，而 类似1.xxxxxx 前面直接使用数字接着一个英文句点则表示有序列表。例如：

无序列表

• content 1
• content 2
• content 3
• content 4

有序列表

1. content 1
2. content 2
3. content 3
4. content 4

上述列表格式在MarkDown编辑器中的写法为：
######无序列表
- content 1    
- content 2
- content 3
- content 4
######有序列表
1. content 1    
2. content 2
3. content 3
4. content 4

---

• 文字修饰（强调符号 * *, _ _）

强调 ，强调
加重强调意味

在MarkDown编辑器中的写法为：*强调* ，_强调_  (预览表现为斜体；**加重强调意味**预览表现为黑体加粗。)

---

• 分隔符

要生成水平分隔线，可以在单独一行里输入3个或以上的短横线、星号或者下划线实现。短横线和星号之间可以输入任意空格。以下每一行都产生一条分隔线。

---

---

---

---

the first content

---

the second content

以上分割线在MarkDown编辑器中的写法为：
* * *                上方第一条分隔线
***                  上方第二条分隔线
- - -                上方第三条分隔线
------------------   上方第四条分隔线
the first content

------------------------------
the second content
（！第一部分结束部分若为文字需先换行，空一行再添加一行分隔符）

• 换行

在文本中输入的换行会从最终生成的结果中删除，浏览器会根据可用空间自动换行。如果想强迫换行，可以在行尾插入至少两个空格。

---

• 行内代码引用

需要引用代码时，如果引用的语句只有一段，不分行，可以用 ` 将语句包起来。
如果引用的语句为多行，可以将```置于这段代码的首行和末行。

例如：![]()；

在MarkDown编辑器中的写法为：
例如：[图片上传失败...(image-da8196-1525536139655)].

本文多次使用了行内代码引用

• 表格

id	name	sex
001	Jeny	girl
002	Lilei	boy
003	charry	girl

在MarkDown编辑器中的写法为：
id | name | sex
----|------|----
001 | Jeny  | girl
002 | Lilei  | boy
003 | charry  | girl

---