MD 是什么
.md 即 markdown 文件的基本常用编写语法,是一种快速标记、快速排版语言
1.基本符号:* - + >
基本上所有的 markdown 标记都是基于这四个符号或组合,需要注意的是,如果以基本符号开头的标记,注意基本符号后有一个用于分割标记符和内容的空格
2.标题
前面带#号,后面带文字,分别表示 h1-h6,只到 h6,而且 h1 下面会有一条横线 –> 相当于标签闭合
3.列表
1 2 3 4 5 6 7 8 9 10 11 12 13 14
| //形式一 + a + b + c
//形式二 - d - e - f
//形式三 * g * h * i
|
1 2 3 4 5 6 7 8 9
| //正常形式 1. abc 2. bcd 3. cde //错序效果 2. fgh 3. ghi 5. hij
|
注意
1 2
| 如图,数字后面的点只能是英文的点,有序列表的序号是根据第一行列表的数字顺序来的, 错序列表的序号本来是序号是乱的, 但是还是显示 2 3 5
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14
| //无序列表嵌套 + 123 + abc + bcd + cde + 465 + 789 //有序列表嵌套 1. abcd 1. abcde 2. abcde 3. abcde 2. bcde 3. cdef
|
列表可以嵌套,使用时在嵌套列表前按 tab 或 空格 来缩进,去控制列表的层数
4.引用说明区块
对某个部分做的内容做一些说明或者引用某某的话等,可以用这个语法
1
| > 引用内容、说明内容。在语句前面加一个 > ,注意是英文的那个右尖括号,注意空格,引用因为是一个区块,理论上是应该什么内容都可以放,比如说:标题,列表,引用等等。
|
效果图
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传 (img-Je0VDV4N-1599483960063)(/hugoblog/引用说明.png)]
这里我只介绍一下我常用的方法,也是个人认为比较规范的一种方法,就是给区块的下一级区块多加一个右尖括号
1 2 3 4 5 6
| > 一级引用 >> 二级引用 >>> 三级引用 >>>> 四级引用 >>>>> 五级引用 >>>>>> 六级引用
|
5.代码块
在发布一些技术文章会涉及展示代码的问题,这时候代码块就显得尤为重要
1
| ` shaoliangdaima,danhangshiyong `
|
1 2 3 4 5 6
| ``` daliangdaima,xuyaoduohangshiyong daliangdaima,xuyaoduohangshiyong daliangdaima,xuyaoduohangshiyong daliangdaima,xuyaoduohangshiyong daliangdaima,xuyaoduohangshiyong
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16
| ### 效果图
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传 (img-Nn3sY16E-1599483960068)(/hugoblog/多行代码.png)]
---
## 6.链接
- 行内式
### 链接的文字放在 [] 中,链接地址放在随后的 () 中,链接也可以带 title 属性,链接地址后面空一格,然后用引号引起来
```python [简书](https://www.jianshu.com "创作你的创作"), 是一个创作社区,任何人均可以在其上进行创作。用户在简书上面可以方便的创作自己的作品,互相交流。
|
链接的文字放在 [] 中,链接地址放在随后的: 后,链接地址后面空一格,然后用引号引起来
1 2 3 4 5 6
| [简书]: https://www.jianshu.com "创作你的创作" [简书]是一个创作社区,任何人均可以在其上进行创作。用户在简书上面可以方便的创作自己的作品,互相交流。 //参数定义的其他写法 [简书]: https://www.jianshu.com '创作你的创作' [简书]: https://www.jianshu.com (创作你的创作) [简书]: <https://www.jianshu.com> "创作你的创作"
|
7.图片
和链接的形式差不多,图片的名字放在 [] 中,图片地址放在随后的 () 中,title 属性(图片地址后面空一格,然后用引号引起来),注意的是 [] 前要加上
1
| ![my-logo.png](https://upload-images.jianshu.io/upload_images/13623636-6d878e3d3ef63825.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240 "my-logo")
|
图片的文字放在 [] 中,图片地址放在随后的: 后,title 属性(图片地址后面空一格,然后用引号引起来),注意引用图片的时候在 [] 前要加上
1 2 3 4 5 6 7 8 9 10
| [my-logo.png]: https://upload-images.jianshu.io/upload_images/13623636-6d878e3d3ef63825.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240 "my-logo"
![my-logo.png]
//参数定义的其他写法 [my-logo.png]: https://upload-images.jianshu.io/upload_images/13623636-6d878e3d3ef63825.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240 'my-logo'
[my-logo.png]: https://upload-images.jianshu.io/upload_images/13623636-6d878e3d3ef63825.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240 (my-logo)
[my-logo.png]: <https://upload-images.jianshu.io/upload_images/13623636-6d878e3d3ef63825.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240> "my-logo"
|
8.分割线
分割线可以由 * - _(星号,减号,底线)这 3 个符号的至少 3 个符号表示,注意至少要 3 个,且不需要连续,有空格也可以
1 2 3 4 5 6 7 8 9
| --- - - - ------ *** * * * ****** ___ _ _ _ ______
|
9.其他
一个星号或者是一个下划线包起来,会转换为 _ 倾斜,如果是 2 个,会转换为加粗_
1 2 3 4 5
| *md* **md** _md_ __md__
|
效果图
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传 (img-3HSJYaiK-1599483960073)(/hugoblog/强调字体.png)]
基本上和 js 转义一样,\加需要转义的字符
用~~把需要显示删除线的字符包裹起来
10.表格
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19
| //例子一 |123|234|345| |:-|:-:|-:| |abc|bcd|cde| |abc|bcd|cde| |abc|bcd|cde| //例子二 |123|234|345| |:---|:---:|---:| |abc|bcd|cde| |abc|bcd|cde| |abc|bcd|cde| //例子三 123|234|345 :-|:-:|-: abc|bcd|cde abc|bcd|cde abc|bcd|cde
|
上面三个例子的效果一样,由此可得
- 表格的格式不一定要对的非常起,但是为了良好的变成风格,尽量对齐是最好的
- 分割线后面的冒号表示对齐方式,写在左边表示左对齐,右边为右对齐,两边都写表示居中