markdown基本语法(在hexo中的使用)

前言

hexo使用markdown来书写博客,所以熟悉了解markdown十分有必要,这是markdown在hexo中的使用,这里介绍markdown的基础以及在hexo中的应用。

一、标题

1
2
3
4
5
# 这是一级标题
## 这是二级标题
### 这是三级标题
#### 这是四级标题
##### 这是五级标题

效果:

这是一级标题

这是二级标题

这是三级标题

这是四级标题

这是五级标题

二、文字

1
2
3
4
**这是加粗的文字**   //用两个*将文字包起即加粗
*这是斜体文字* //用一个*将文字包起即斜体
***这是加粗同时斜体的文字*** //用三个*将文字包起即加粗斜体
~~这是加删除线的文字~~ //要加删除线的文字左右分别用两个~~号包起来

效果:

这是加粗的文字
这是斜体文字
这是加粗同时斜体的文字
这是加删除线的文字

三、引用

在引用的文字前加>即可。引用也可以嵌套,如加两个>>三个>>>n个…

1
2
3
>这是引用的内容
>>这是引用的内容
>>>这是引用的内容

效果:

这是引用的内容

这是引用的内容

这是引用的内容

四、分割线

几种样式,效果一样

1
2
3
4
---
----
***
*****





五、图片

图片alt
图片alt就是显示在图片下面的文字,相当于对图片内容的解释。
图片title是图片的标题,当鼠标移到图片上时显示的内容。title可加可不加
龙猫
还可以用html标记来插入图片:

1
<img width=200 src="../images/lm.jpg"/>


并且可以自定义大小
但是hexo中使用以上两种方式会导致一些问题,所以在hexo中建议使用以下方法:

1
{% asset_img example.jpg This is an example image %}

六、超链接

1
[超链接名](超链接地址 "超链接title")

title可加可不加
示例:

1
[百度](https://www.baidu.com)

百度
一样的可以使用html标记来插入超链接:

百度
并且可以设置在新窗口打开

七、列表

无序:

1
2
3
- 列表内容
+ 列表内容
* 列表内容

注意:- + * 跟内容之间都要有一个空格

  • 列表内容
  • 列表内容
  • 列表内容

用html标记也可以:

1
2
3
4
5
<ul>
<li>列表内容1</li>
<li>列表内容2</li>
<li>列表内容3</li>
</ul>

有序:

数字加点:

1
2
3
1. 列表内容
2. 列表内容
3. 列表内容

  1. 列表内容
  2. 列表内容
  3. 列表内容

注意:序号跟内容之间要有空格

八、表格

1
2
3
4
表头|表头|表头
---|:--:|---:
内容|内容|内容
内容|内容|内容
表头 表头 表头
内容 内容 内容
内容 内容 内容

第二行分割表头和内容。
-有一个就行,为了对齐,多加了几个
文字默认居左
-两边加:表示文字居中
-右边加:表示文字居右
注:原生的语法两边都要用 | 包起来。此处省略
同样,可以用html标记实现:

1
2
3
4
5
<table>
<tr><td>表头</td><td>表头</td><td>表头</td></tr>
<tr><td>内容</td><td>内容</td><td>内容</td></tr>
<tr><td>内容</td><td>内容</td><td>内容</td></tr>
</table>





表头表头表头
内容内容内容
内容内容内容

九、代码

单行代码:代码之间分别用一个反引号包起来
代码内容
代码块:代码之间分别用三个反引号包起来,且两边的反引号单独占一行

1
2
3
代码...
在开头的三个反引号后面加上语言名称还可以显示对应高亮
代码...

代码高亮

十、流程图

由于hexo不支持流程图所以不做演示

十一、在实际使用过程中遇到的一些问题以及解决办法

在实际的使用过程中使用markdown在hexo编写文章有时会遇到一些意想不到的问题,这里来进行一个汇总以及解决办法:

  • 在hexo中使用表格的时候在vscode中预览的时候是好好的,可是当打开网页之后却会出现表格上方会出现大量的留白的情况,检查网页代码发现是网页中多了很多的换行符

    那么解决办法是在表格使用 `` 与 ``包裹起来,然后再回去查看网页,ok,问题解决。
-------------本文结束感谢您的阅读-------------