第一次接触markdown是在项目中的readme中见到的,当时对它的感觉是很神奇的,不需要任何编辑器,通过几个简单的字符或者书写格式,就可以达到自己想要的呈现方式。当然,最让我想好好学习它的原因当然还是这里必须要用到它。 以下是markdown的一些常用书写格式:
标题
markdown一共有六级标题,一级标题字体最大,文字前面的#数量即代表标题的级数:
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
注:# 和「一级标题」之间建议保留一个字符的空格,这是最标准的 Markdown 写法。
列表
列表格式只需在文字前面加上 - 即可:
- 马云
- 马化腾
- 马冬梅
有序列表将 - 换成 1. 即可:
1. 马云
2. 马化腾
3. 马冬梅
注:- 、1.和文本之间要保留一个字符的空格。
链接和图片
在 Markdown 中,插入链接不需要其他按钮,你只需要使用[显示文本](链接地址)
这样的语法即可,例如:
新浪
[新浪](www.sina.com)
在 Markdown 中,插入图片不需要其他按钮,你只需要使用[图片上传失败...(image-743e1-1533801654764)]
这样的语法即可,例如:
![](https://img.haomeiwen.com/i259/0ad0d0bfc1c608b6.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
引用
在我们写作的时候经常需要引用他人的文字,这个时候引用这个格式就很有必要了,在 Markdown 中,你只需要在你希望引用的文字前面加上 > 就好了,例如:
>八百里分麾下炙,五十弦翻塞外声
八百里分麾下炙,五十弦翻塞外声。
粗体和斜体
粗体 **粗体**
斜体 *斜体*
行内代码一级代码块
行内代码:使用两个反单引号 把内容包裹起来 `ZMR`
代码块: 换行之后使用 两个tab键即可
这里需要隔一行在使用table键
表格
| Tables | Are | Cool |
| ------------- |:-------------:| -----:|
| col 3 is | right-aligned | $1600 |
| col 2 is | centered | $12 |
| zebra stripes | are neat | $1 |
第一行为定义表格头部标题,而第二行是区分头部和设置对齐方式, 减号(-)至少有3个.
表格外围的管道的可选的, 也不需要让每行的每个TD的管道对齐.
最简单的写法也可以像下面那样,但是看代码就没上面的那么好看了,尽管最后的显示效果都一样.
在减号的两侧定义冒号":" 可设置该竖行的对齐方式, 左边加等于左对齐,两边都加等于居中对齐.
效果如下
Tables | Are | Cool |
---|---|---|
col 3 is | right-aligned | $1600 |
col 2 is | centered | $12 |
zebra stripes | are neat | $1 |
分割线
使用三个以上的 - 即可
name | age |
---|---|
ZMRWEGo | 22 |
网友评论