Markdown语法的介绍

怎样在网站上书写我们的第一篇博客吧

一、创建文章

在站点文件夹中打开 git bash,输入如下命令创建文章,其中 name 为文章的标题

1
$ hexo new "name"

当输入命令后,就会在 source/_post 文件夹下创建一个文件,命名为:name.md
这个文件就是将要发布到网站上的原始文件,用于记录文章内容

二、编写文章(基于 Markdown)

1、Markdown 简介

Markdown 是一种可以使用普通文本编辑器编写的 标记语言,通过简单的 标记语法,它可以使普通文本内容具有一定的格式
基于 Markdown 语法的简洁性,它已经成为目前世界上最流行的用于书写博客的语言

2、Markdown 语法

Typora-Markdown编辑器
简单而强大,支持原生的语法,也支持对应的快捷键,还可以 实时预览
Typora 的下载地址:https://www.typora.io/

三、常用的 Markdown 语法

1.标题

Markdown 语法:

#一级标题

##二级标题

###三级标题

####四级标题

#####五级标题

######六级标题
Typora 快捷键:
Ctrl+1:一级标题
Ctrl+2:二级标题
Ctrl+3:三级标题
Ctrl+4:四级标题
Ctrl+5:五级标题
Ctrl+6 :六级标题
Ctrl+0:段落

2.粗体、斜体、删除线和下划线

Markdown 语法:

1
2
3
4
*斜体*
**粗体**
***加粗斜体***
~~删除线~~

Typora 快捷键:
Ctrl+I:斜体
Ctrl+B:粗体
Ctrl+U:下划线
Alt+Shift+5:删除线

3.引用块

Markdown 语法:

1
2
> 文字引用
Typora 快捷键: Ctrl+Shift+Q

4.代码块

Markdown 语法:

1
`行内代码`

1
``` 多行代码  ```

Typora 快捷键:

行内代码:Ctrl+Shift+`

多行代码:Ctrl+Shift+K

5.公式块

Markdown 语法:

1
2
3
$$ 
数学公式
$$

Typora 快捷键: Ctrl+Shift+M

6.分割线

Markdown 语法:

1
2
3
4
5
方法一:---

方法二:+++

方法三:***

7.列表

Markdown 语法:

1
2
3
4
5
6
7
.有序列表项

*无序列表项

+无序列表项

-无序列表项

Typora 快捷键:

有序列表项:Ctrl+Shift+[

无序列表项:Ctrl+Shift+]

8.表格

Markdown 语法:

1
2
3
4
表头1|表头2
-|-|-
内容11|内容12
内容21|内容22

Typora 快捷键: Ctrl+T

9.超链接

Markdown语法:

1
2
3
4
5
方法一[](链接地址 "链接描述")
如[](https://www.example.com/ "示例链接")

方法二:<链接地址>
如:<https://www.example.com/>

Typora快捷键: Ctrl+K

##10.图片
Markdown语法:

1
2
![图片文字](图片地址 "图片描述")
如:![示例图片](https://www.example.com/example.PNG "示例图片")

Typora快捷键: Ctrl+Shift+I

注:

安装插件 npm install hexo-asset-image –save

将 站点配置文件 中的 post_asset_folde: true

这样,当使用 hexo new name文章时,将同时在 source/_post 文件夹中生成一个 name文件夹,我们只需将图片放进此文件夹中,然后在文章中通过 Markdown语法写入
如:在资源文件夹(就是那个与 name文件夹)中添加图片 example.PNG,则可以在对应的文章中使用语句 ![示例图片](title/example.PNG "示例图片")添加图片

四、高级设置

1.模板设置

当我们使用命令 hexo new “title” 创建文章时,Hexo 会根据 /scaffolds/post.md 对新文章进行初始化
换言之,/scaffolds/post.md 就是新文章的 模板,所以我们可以修改它来适应自己的写作习惯
一个简单的示例如下:
title: Markdown语法的介绍
date: 1552301438923
tags:
categories:

2.头部设置

在每篇利用 Hexo 创建的文章的开头,都会有对文章进行说明的文字,叫做 文章头部
文章的头部除了可以设置文章标题、发布日期等基础信息外,还可以为文章添加标签、分类等
一个简单的示例如下:
title: Title
date: YYYY-MM-DD HH:MM:SS
tags: [tag1, tag2, …]
categories: category
注意:属性和属性值之间必须有一个空格,否则会解析错误

3.首页显示

在利用 Hexo 框架搭建的博客网站中,首页会显示文章的内容,且默认显示文章的全部内容
如果当文章太长的时候就会显得十分冗余,所以我们有必要对其进行精简
这时,我们只需在文章中使用 标志即可,表示只会显示标志前面的内容

五、部署发布

1
$ hexo g -d

建议:在使用 hexo g 部署之后,可以先使用 hexo s 运行本地站点,然后在浏览器输入地址 http://lacolhost:4000/ 查看运行结果,检查无误后再使用 hexo d 发布

0%