1 关于Markdown
Markdown是一种轻量级标记语言,它的目的是希望大家使用“易于阅读、易于撰写的纯文字格式,并选择性的转换成有效的HTML(或XHTML)”。
-
优点
-
易读
易读是指Markdown文件(即 .md 文件)容易阅读,与HTML相比,它没有各种繁杂的尖括号<>和缩进。整体简洁美观。
-
易写
使用Markdown可以让你专注于文字,不用像office软件一样需要用鼠标疯狂点击那些排版按钮,可以做到手不离键盘且快速高效的将写作与排版一气呵成。而且Markdown语法简单,花半个小时就能学会基本语法。
-
-
缺点
-
标准不统一
目前Markdown语法众多、编辑器层出不穷,每个编辑器支持的语法也不同,这就导致在一个编辑器上写的md文件,放到其它编辑器上,出现排版混乱,甚至是不支持某些语法的现象。这就是人们所说的 “方言现象”,这也是目前Markdown最突出的问题。
-
图片支持不够
不能直接显示图片,不能调整大小。且不同编辑器对图片的处理也有所不同。
-
表格支持不够
原生的Markdown是不支持表格的,但现在大部分编辑器都支持简单的表格,也有支持复杂表格的语法,但是书写困难,且不被大多数编辑器支持。
-
占用特殊字符
Markdown的语法占用了一些特殊字符,导致想在文本中输入特殊字符的时候,需要进行转义操作。
-
-
使用群体
- 喜欢写博客的人
- 经常阅读书写各种技术文档的技术人员
- 混迹于各种技术论坛和社区的程序员
- 追求简洁排版、快速编辑的文字工作者
2 基本语法
2.1 标题
只需要在文本前面加上 #
号即可(注意#号后面有一个空格
),二级标题加两个 ##
,三级标题加三个 ###
,以此类推,最多六级标题。
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
2.2 列表
1. 无序列表
使用 *,+,-
表示无序列表。列表可以嵌套,上一级和下一级之间敲三个空格即可,建议相同级别的列表项使用相同的符号,并且保持缩进一致,如一级列表用 *
,二级列表用 +
,三级列表用 -
。 (注意后面需要加空格)
示例:
* 无序列表项1
+ 无序列表项1.1
- 无序列表项1.1.1
+ 无序列表项1.2
- 无序列表项1.2.1
* 无序列表项2
* 无序列表项3
效果如下:
- 无序列表项1
- 无序列表项1.1
- 无序列表项1.1.1
- 无序列表项1.2
- 无序列表项1.2.1
- 无序列表项1.1
- 无序列表项2
- 无序列表项3
2. 有序列表
使用数字和点表示有序列表。(注意后面需要加空格)
示例:
1. 有序列表项
2. 有序列表项
3. 有序列表项
效果如下:
- 有序列表项
- 有序列表项
- 有序列表项
2.3 字体
*斜体*
**加粗**
***斜体加粗***
~~删除线~~
效果如下:
- 斜体
- 加粗
- 斜体加粗
删除线
2.4 引用
在引用的文字前加>即可。引用也可以嵌套,如加两个>>三个>>>,貌似可以一直嵌套下去。
> 引用
>> 引用
>>> 引用
>>>>>>>> 引用
效果如下:
引用
引用
引用
引用
2.5 分割线
使用三个或三个以上的 -
或 *
。
示例:
---
--------
***
********
效果如下:
2.6 超链接
加入超链接的格式如下:
[链接名字](链接地址, "链接title")
其中链接title可以不填。
例如:
[百度一下](https://www.baidu.com/)
注意:不能直接写成 www.baidu.com
,需要加 https://或http://
效果如下,点击即可访问:
百度一下
2.7 插入图片
插入图片的格式如下:
![图片描述](图片地址)
其中图片title可以不填。
例如:
![tree](http://hru.com/blog/180910/84.jpg?imageim)
效果如下:
2.8 表格
下面是一般表格的书写格式:
表头|表头|表头
---|---|---
内容|内容|内容
内容|内容|内容
表的两边可以加 | 将表包围起来,也可以不加,效果一样,如下所示:
|表头|表头|表头|
|---|---|---|
|内容|内容|内容|
|内容|内容|内容|
Markdown默认表的内容是左对齐,标题是居中对齐,我们可以根据需要,使用 :
来进行对齐。
示例:
左对齐|居中|右对齐
:---|:---:|---:
内容|内容|内容
内容|内容|内容
"-"短线每一栏加1个就够了,这里为了对齐,都加了3个。
左边加":"表示文字居左。
两边加":"表示文字居中。
右边加":"表示文字居右。
效果如下:
左对齐标题 | 居中标题 | 右对齐标题 |
---|---|---|
内容 | 内容 | 内容 |
内容 | 内容 | 内容 |
2.9 代码
Markdown可以内嵌代码,还支持代码高亮,不同开发语言有不同的高亮形式。
语法如下:
单行代码使用两个 ` 将代码包围起来:
> `代码`
多行代码使用两个 ``` 加代码语言标识:
> (``` 语言标识)
> 代码块
> (```)
上面的括号和>不用写,这里为了方便展示多加了,请忽略
语言标识是对各种语言的分类,如:python,c,bash,java,php,sql......
效果如下:
单行代码: unsigned int a;
多行代码(语言标识:C):
int main()
{
int a = 9;
printf("%d\n", a);
return 0;
}
2.10 待办事宜 Todo 列表
使用带有 [ ] 或 [x] (未完成或已完成)项的列表语法撰写一个待办事宜列表,并且支持子列表嵌套以及混用Markdown语法,例如:
- [ ] 一级任务
- [ ] 二级任务
- [x] 二级任务
- [x] 二级任务
- [x] 三级任务
- [x] 三级任务
- [ ] 一级任务
- [ ] 二级任务
效果如下:
- [ ] 一级任务
- [ ] 二级任务
- [x] 二级任务
- [x] 二级任务
- [x] 三级任务
- [x] 三级任务
- [ ] 一级任务
- [ ] 二级任务
3、支持Markdown语法的软件或网站
编辑软件:
- atom —— 21世纪黑客文本编辑器,里面有各种插件,程序猿专用软件,也是我目前在用的编辑软件。
- Visual Studio Code —— 一心想要统治地球的软件,对Markdown语法要求严格,经常会出现红波浪线和绿波浪线。
- MarkdownPad —— 一款全功能的编辑器,被很多人称赞为windows 平台最好用的markdown编辑器。
- Sublime Text 2 —— 界面简约大方,定位专业。
- Smark
- MdCharm
网站(在线编辑器):
- —— 一个很好的博客平台,简约美观,写文章时可以直接拖入图片生成链接。
- dillinger —— 支持md, html, pdf 文件导出。支持dropbox, onedrive,google drive, github.
- Cmd Markdown
- 小书匠编辑器
如果上面没有适合你的编辑器,请自行上网查找其它的编辑器。