既然要写技术博客,那么markdown肯定是必备的了,这篇文章就来介绍一下markdown的基本使用操作。
References:
电子文献:
https://www.jianshu.com/p/191d1e21f7ed
介绍
Markdown是一种可以使用普通文本编辑器编写的标记语言,其功能比纯文本更强,因此许多程序员用它来写blog。在这里我先推荐一款markdown编辑器——typora,大家可以免费下载使用。
注意
在我刚开始使用markdown的时候总是跳进这个坑,在这里提上来提醒一下,在使用markdown标记后要添加文字时,需要在相应标记后空一格,否则标记也会被当作文本来处理,例如我输入“#####错误”时:
错误
正确的做法是输入“##### 正确”:
正确
一种简单的判别方法就是使用IDE,这样对应的标记就会有语法高亮。
使用
标题
话不多说,直接示范:
1
2
3
4
5
6# 这是一级标题
## 这是二级标题
### 这是三级标题
#### 这是四级标题
##### 这是五级标题
###### 这是六级标题效果如下:
这是一级标题
这是二级标题
这是三级标题
这是四级标题
这是五级标题
这是六级标题
字体
还是直接示范:
1
2
3
4**这是加粗的文字**
*这是倾斜的文字*`
***这是斜体加粗的文字***
~~这是加删除线的文字~~这是加粗的文字
这是倾斜的文字
这是斜体加粗的文字这是加删除线的文字引用
1
2
3
4>我引用
>>我还引用
>>>我再引用
>>>>>>>>>>>>>扶我起来,我还能继续引用!我引用
我还引用
我再引用
扶我起来,我还能继续引用!
引用是可以嵌套的,可以加很多层,我一般使用一个
>
来表示额外的需要注意的内容。另外,如果想让下一段文字不被引用,需要空一行。分割线
分割线使用三个及以上的
-
或*
就可以。
有时候用---
会造成别的文字的格式变化,因此我在使用VScode编辑时,如果看到---
被高亮(分割线正常其作用时应该不高亮),就会改用***
。1
2---
***效果如下:
图片
markdown中添加图片的语法是这样的:
1
![显示在图片下方的文字](图片地址 "图片title")
其中title可加可不加,它就是鼠标移动到图片上时显示的文字。
然而我在使用hexo搭建我的个人博客的过程中,遇到了使用上述语法图片却无法显示的情况,因此我改用了下列标签插件:1
{% asset_img xxxxx.xxx 图片下方的名字 %}
其中xxxxx.xxx只需直接输入图片名称以及格式即可,因为我使用了hexo-asset-image插件,它可以在_posts文件中创建与博文名称相同的对应的文件夹,只需把图片移入即可。注意,这里的图片名中间不能有空格,否则会加载失败(它会以为图片名称到第一个空格为止)。
其安装命令:npm install hexo-asset-image --save
也可用cnpm更快地安装:cnpm install hexo-asset-image --save
补充:后来发现在关于本人中无法使用上述asset_img标签插件来对图片进行插入,故又尝试了
![显示在图片下方的文字](图片地址 "图片title")
的方法,发现可行!原因可能是之前误用了中文括号导致的。可以参考一下Hexo文章中插入图片的方法。在插入图片的后面,会留有一小段空白区,看着不舒服的话可以不要回车,即直接在插入图片的语句后面跟进下一段的文字或者图片等,这样行间隙就会小很多。
其实在hexo中可以直接使用img标签,它会自行处理,并且这样还更方便调整高度和宽度。1
<img src="" width="50%" height="50%">
超链接
由于我希望在新的页面打开链接,而似乎markdown本身的语法不支持在新标签页打开链接,因此我推荐直接使用html语言来代替。
1
<a href="超链接地址" target="_blank">超链接名</a>
列表
无序列表
1
2
3- 列表内容
+ 列表内容
* 列表内容- 列表内容
- 列表内容
- 列表内容
有序列表
1
2
31. 列表内容
2. 列表内容
3. 列表内容- 列表内容
- 列表内容
- 列表内容
可以看到,上面显示的列表是有嵌套的,方法就是敲三个空格缩进。
表格
1
2
3
4表头|表头|表头
---|:--:|---:
内容|内容|内容
内容|内容|内容其中第二行的作用分割表头和内容,
-
有一个就行,为了对齐可多加几个。
此外文字默认居左,有两种改变方法:
两边加:表示文字居中。
右边加:表示文字居右。
然而我在hexo使用表格时,出现了无法正常转换的问题,因此我改用了如下HTML的表格形式。1
2
3
4
5
6
7
8
9
10<table border="1">
<tr>
<td>第一行第一列</td>
<td>第一行第二列</td>
</tr>
<tr>
<td>第二行第一列</td>
<td>第三行第二列</td>
</tr>
</table>效果如下:
第一行第一列 第一行第二列 第二行第一列 第二行第二列 代码
最后的最后,是我最喜欢
ctrl+C+V
的代码了。
单行或句中代码输入方式:1
`来复制我呀`
显示:
来复制我呀
其中“`”在键盘的左上角,我当初找了好久。
多行代码块的写法就是用上下两对“```”围住。
好了于是你现在就可以自由的复制粘贴啦。