一、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
有序列表
- content 1
- content 2
- content 3
- 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