Markdown语法很简单
本文首发于:https://qinshijia.github.io/2018/08/13/markdown-introduction/
Markdown简介
Markdown是一种轻量级的标记语言,目标是实现易读易写。
简单的语法规则,漂亮的显示效果,容易读写随意改,是Markdown的特点。使用Markdown写作,能让您专注于内容,不需要浪费大量时间去排版。很多博客、在线笔记等工具都支持Markdown格式的文档,例如GitHub、Stack Overflow、简书、为知笔记。
下面会介绍常用的Markdown语法。
Markdown语法
标题
Markdown中标题分为六级,在行首以 # 开头并空一格再写标题文字。# 的个数标题的级数,一级标题字体最大,六级标题字体最小。
# 这是一级标题
## 这是二级标题
### 这是三级标题
#### 这是四级标题
##### 这是五级标题
###### 这是六级标题
段落
段落没有标记,段落的前后应该有一个以上空行。段落不推荐使用缩进。
链接
链接标记是一个中括号和一个小括号连在一块,中括号内是要链接的文字,小括号是链接地址,例如这样。链接可以是绝对地址,也可以是相对地址。
[百度](https://www.baidu.com/)
图片
插入图片需要先保存好图片,然后再通过引入图片的方式显示。
图片的标记是一个感叹号、中括号和小括号连在一起,中括号里是图片加载不出来时显示的文字,小括号里是图片的链接地址。
下面这张图片的写法是:
![Markdown图标](https://img.haomeiwen.com/i13557430/772d6394ecaf885a.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
Markdown图标
段内代码
段内代码标记是由两个 ` 符号(键盘上制表符上面,1旁边的按键)组成,两个`中间是要显示的代码,例如这样 Hello world!
。
`Hello world!`
代码块
代码块是在开头和结尾都以三个连续的 ` 符号组成,中间为显示的代码。怎么没有行号?那是Markdown解析后前端显示的问题,不是语法的问题。
String text = "Hello world!";
System.out.print(text);
引用
在段落的开头使用 > 符号即可,显示的效果如下:
这是一段引用
> 这是一段引用
无序序列
无序序列在行开头使用 * 或者 - 或者 + 即可。显示效果如下
- 无序序列
- 无序序列
- 无序序列
* 无序序列
- 无序序列
+ 无序序列
有序序列
有序列表则使用数字接着一个英文句点,数字的大小顺序对显示的结果没有影响,显示结果会按照行的顺序重新编号。
- 有序序列1
- 有序序列2
- 有序序列3
1. 有序序列1
1. 有序序列2
1. 有序序列3
表格
表格是用符号 | 标记,在 | 之间的就是表格的内容。第一行是表头,第二行是控制表格显示方式,第三行以后是表格内容。
靠左显示 | 居中显示 | 靠右显示 |
---|---|---|
第二行使用符号 :- | 第二行使用符号 :-: | 第二行使用符号 -: |
|靠左显示|居中显示|靠右显示|
|:-|:-:|-:|
|第二行使用符号 :-|第二行使用符号 :-:|第二行使用符号 -:|
强调
强调是在段内的 * 之间插入要强调的文字,一个*是斜体,连续两个 **是加粗,例如 我想倾斜一下, 我想加粗一下。
*我想倾斜一下*
**我想加粗一下**
Markdown工具推荐
Markdown 语法已经足够简单了,使用常用的文本编辑器就能完成写作。随着 Markdown 越来越流行,配套工具也丰富了起来,语法高亮、实时预览、图片粘贴等功能也很吸引人。
这里推荐一款文本编辑器 Atom,它着丰富的插件库,在 Atom 的 File -> settings -> install中搜索相应插件然后安装即可,使用方法在搜索结果界面点进去都有介绍。 Markdown 相关的插件有以下这些:
- markdown-writer:语法高亮
- markdown-scroll-sync:编写的时候按了 Ctrl + Shift + M,之后能同步滚动预览
- markdown-image-assistant:截图之后直接按 Ctrl + V 粘贴
其他工具可以看一下Markdown 在线编辑阅读器及应用收集。