一、Markdown介绍
Markdown是一种轻量级标记语言,创始人为约翰·格鲁伯(英语:John Gruber)。它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。——百度百科
Markdown 能被使用来撰写电子书,如:Gitbook。
- 目前网站都广泛使用 Markdown 来撰写帮助文档或是用于论坛上发表消息。例如:GitHub、简书、reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge等。
- 使用Markdown的优点:
纯文本,兼容性强,可以用所有文本编辑器打开。
自动排版,让你专注于文字。
格式转换方便,Markdown 文本可以轻松转换为PDF、html、Word、Epub、图片等。
二、编辑器推荐
1.在线编辑
- StackEdit
浏览器访问StackEdit - 简书
浏览器访问简书
开启方式:设置->默认编辑器->Markdown编辑器
2.离线编辑
- Typora客户端
适用于MacOS、Windows、Linux各系统 - Markdown Pad客户端
适用于Windows系统 - Mou客户端
适用于Mac系统
三、Markdown基本语法
注意:所有符号均为英文输入法下的符号。1.标题
- 六级标题使用#可以表示1~6级标题,1个#表示一级标题,2个#表示二级标题。以此类推。
注意:#和标题之间最好加上空格。语法:
显示效果:这是一级标题# 这是一级标题 ## 这是二级标题### 这是三级标题#### 这是四级标题##### 这是五级标题###### 这是六级标题
这是二级标题
这是三级标题
这是四级标题
这是五级标题
这是六级标题
大小标题
≥3个=可以表示一级标题, ≥3个-可以表示二级标题。 语法:这是一级标题===这是二级标题---
2.段落格式
- 字体Markdown 可以使用以下几种字体:使用*表示斜体文本,**表示粗体文本,***表示粗斜体文本。语法:
显示效果:斜体文本*斜体文本*
**粗体文本**
***粗斜体文本***
***
___
显示效果:
删除线 如果文字需要加上删除线,可以在文字两端各自加两个波浪线
~~
实现。
语法:
~~删除文本~~
显示效果:
删除文本
下划线
如果文字需要加下划线,可以用标签实现。
语法:
带下划线文本
显示效果:
带下划线文本
3.列表
Markdown 支持有序列表和无序列表。
有序列表
有序列表用数字加.表示。
语法:
1.第一项2.第二项3.第三项
显示效果:
1.第一项
2.第二项
3.第三项- 无序列表无序列表用*或+或-表示。语法:
* 第一项- 第二项
显示效果:
第一项
第二项
- 列表嵌套
在一级列表中嵌套二级列表元素时,需要在嵌套的二级列表之前加四个空格。
语法:
1.第一项 * 第一项嵌套的第一个二级列表 * 第一项嵌套的第二个二级列表* 第二项 1.第二项嵌套的第一个二级列表元素 2.第二项嵌套的第二个二级列表元素
显示效果:
1.第一项
-
第一项嵌套的第一个二级列表
第一项嵌套的第二个二级列表
第二项
1.第二项嵌套的第一个二级列表元素
2.第二项嵌套的第二个二级列表元素
- 引用
段落开头使用 > 符号加一个空格。语法:
显示效果:> 引用文字
引用文字
- 区块嵌套
区块可以嵌套,一个>是最外层,两个>是第一层嵌套,以此类推。语法:
显示效果:> 最外层
>> 第一层嵌套
>>> 第二层嵌套
最外层区块中使用列表第一层嵌套第二层嵌套
在区块中直接使用列表即可。 语法:
> 1.第一项
> * 第二项
显示效果:
1.第一项列表中使用区块
- 第二项
在列表中使用区块时,需要在>加空格前面加上四个空格。 语法:
1.第一项
>引用文本
2.第二项
显示效果:
1.第一项
>引用文本
2.第二项
5.链接
链接
方括号里写网站名称,后面圆括号内写网址。
语法:
[必应](https://cn.bing.com/)或者<https://cn.bing.com/>
高级链接
可以用变量来设置链接,在文档最后进行赋值。 语法:这个链接用 1 作为网址变量 [Bing][1]这个链接用 jianshu 作为网址变量 [简书][jianshu]然后在文档的结尾为变量赋值(网址) [1]: https://cn.bing.com/ [jianshu]: https://www.jianshu.com/
6.图片
图片
插入图片与链接方法相似,需要在前面加一个!,表示为:!加[图片替代文字]加(图片网址)。
语法:
![简书Logo](https://upload-images.jianshu.io/upload_images/24804176-586f83674e86ebe5.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
显示效果:
![0afc97443f66657bdab96f743ac198bf.png](https://img-blog.csdnimg.cn/img_convert/0afc97443f66657bdab96f743ac198bf.png)
高级图片
插入图片与链接方法相似,都可以用变量赋值图片网址。
语法:
这个链接用 1 作为网址变量 [Can't Breath][1] 然后在文档的结尾为变量赋值(网址) [1]:https://images.pexels.com/photos/4677668/pexels-photo-4677668.jpeg?auto=compress&cs=tinysrgb&dpr=1&w=500
修改图片尺寸
可以使用Html的标签自定义图片的尺寸。语法:
- 段落内代码
段落内代码可以用反引号`表示。也可用其进行高亮显示。语法:
显示效果:`hello world`
hello world
- 代码区块
代码前使用四个空格或者制表符Tab。语法:
显示效果:hello worldhello world
hello world
hello world - 一段代码可以用三个反引号```包裹一段代码。显示效果:
代码段
- 表格使用|分隔不同的单元格,-分隔表头和其他行。表格中用冒号设置对齐方式,:---用来设置单元格左对齐,---:表示右对齐,:---:则为居中对齐。语法:
显示效果:|表头1|表头2|表头3|
|:---|:---:|---:|
|A1单元格|B1单元格|C1单元格|
|A2单元格|B2单元格|C2单元格|
表头1 表头2 表头3 A1单元格 B1单元格 C1单元格 A2单元格 B2单元格 C2单元格
四、语法总结
Markdown基础语法总结
功能 | 语法 | 输出结果 | 备注 |
标题 | #*N N级标题 | N级标题 | #和标题之间最好加上一个空格 |
斜体 | * | 斜体文本 | |
粗体 | ** | 粗体文本 | |
粗斜体 | * | 粗斜体文本 | |
删除线 | ~~ | 删除文本 | |
下划线 | 带下划线文本 | ||
有序列表 | 1.第一项 | 1.第一项 | |
无序列表 | - 第一项 | * 第一项 | 表格不支持,文本中可实现 |
区块引用 | > | > 引用文本 | 表格不支持,文本中可实现 |
链接 | []括号 | 链接名称 | |
图片 | []括号 | ||
行内代码 | ` | 代码 | 英文状态点击Esc键即可输入反引号 |
代码块 | ``` | 代码段 | |
表格 | 竖线和- | 参见上表 |