MarkDown是什么这里就不多说了,具体参考我的技术博客

了解文章目录

所有的文章都是放在主目录下source文件下的_posts目录下的,这里参考我的存放目录C:\Users\user\Desktop\lovelijunyi\source\_posts

这里作出两点说明:

  1. 该目录下可以再创建目录,系统可以识别到多层文件夹中的文章,方便分类
  2. 如果用命令生成的新文章一定是在_posts主目录下

熟悉操作指令

其实就是一句话,再把生成的文章拖到_posts目录下你自己创建的文件夹即可,文件后缀为.md

1
hexo n 你的文章名

Tips: 如果嫌麻烦,复制md文件再粘贴也是个好办法

开始书写文章

写MarkDown这里推荐Typora,非常好用,点开创建的文件,先看看里面有啥

1
2
3
4
---
title: typora-vue-theme主题介绍
date: 2018-09-07 09:25:00
---

两个虚线之间的内容就是叫Front-matter,主要是你文章的配置,具体配置如下,这里不同主题不一样,我以Matery主题为例

Front-matter 选项中的所有内容均为非必填的。但我仍然建议至少填写 titledate 的值。

配置选项 默认值 描述
title Markdown 的文件标题 文章标题,强烈建议填写此选项
date 文件创建时的日期时间 发布时间,强烈建议填写此选项,且最好保证全局唯一
author _config.yml 中的 author 文章作者
img featureImages 中的某个值 文章特征图,推荐使用图床(腾讯云、七牛云、又拍云等)来做图片的路径.如: http://xxx.com/xxx.jpg
top true 推荐文章(文章是否置顶),如果 top 值为 true,则会作为首页推荐文章
cover false v1.0.2版本新增,表示该文章是否需要加入到首页轮播封面中
coverImg v1.0.2版本新增,表示该文章在首页轮播封面需要显示的图片路径,如果没有,则默认使用文章的特色图片
password 文章阅读密码,如果要对文章设置阅读验证密码的话,就可以设置 password 的值,该值必须是用 SHA256 加密后的密码,防止被他人识破。前提是在主题的 config.yml 中激活了 verifyPassword 选项
toc true 是否开启 TOC,可以针对某篇文章单独关闭 TOC 的功能。前提是在主题的 config.yml 中激活了 toc 选项
mathjax false 是否开启数学公式支持 ,本文章是否开启 mathjax,且需要在主题的 _config.yml 文件中也需要开启才行
summary 文章摘要,自定义的文章摘要内容,如果这个属性有值,文章卡片摘要就显示这段文字,否则程序会自动截取文章的部分内容作为摘要
categories 文章分类,本主题的分类表示宏观上大的分类,只建议一篇文章一个分类
tags 文章标签,一篇文章可以多个标签
keywords 文章标题 文章关键字,SEO 时需要
reprintPolicy cc_by 文章转载规则, 可以是 cc_by, cc_by_nd, cc_by_sa, cc_by_nc, cc_by_nc_nd, cc_by_nc_sa, cc0, noreprint 或 pay 中的一个

注意:

  1. 如果 img 属性不填写的话,文章特色图会根据文章标题的 hashcode 的值取余,然后选取主题中对应的特色图片,从而达到让所有文章都的特色图各有特色
  2. date 的值尽量保证每篇文章是唯一的,因为本主题中 GitalkGitment 识别 id 是通过 date 的值来作为唯一标识的。
  3. 如果要对文章设置阅读验证密码的功能,不仅要在 Front-matter 中设置采用了 SHA256 加密的 password 的值,还需要在主题的 _config.yml 中激活了配置。有些在线的 SHA256 加密的地址,可供你使用:开源中国在线工具chahuo站长工具
  4. 您可以在文章md文件的 front-matter 中指定 reprintPolicy 来给单个文章配置转载规则

以下为文章的 Front-matter 示例。

最全示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
---
title: typora-vue-theme主题介绍
date: 2018-09-07 09:25:00
author: 赵奇
img: /source/images/xxx.jpg
top: true
cover: true
coverImg: /images/1.jpg
password: 8d969eef6ecad3c29a3a629280e686cf0c3f5d5a86aff3ca12020c923adc6c92
toc: false
mathjax: false
summary: 这是你自定义的文章摘要内容,如果这个属性有值,文章卡片摘要就显示这段文字,否则程序会自动截取文章的部分内容作为摘要
categories: Markdown
tags:
- Typora
- Markdown
---

Tips:你会发现一个问题,每次hexo n的时候Front-matter中内容少的可怜,那怎么修改默认的格式呢?只要去主目录下找到scaffolds文件夹下找到一个post.md文件修改即可,这里是我的目录C:\Users\user\Desktop\lovelijunyi\scaffolds,例如我的

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
---
# 标题
title: {{ title }}
date: {{ date }}
author: 无敌小小弋
# 简述
summary:
# 使用自定义封面
img:
# 是否置顶true,或者去掉
top: true
# 轮播
cover:
# 轮播图
coverImg:
# 标签
tags:
# 分类
categories:
# 是否加密文章,SHA256加密
password:
---

首行缩进方法

由于markdowm会自动限定格式,所以缩进显得比较困难,通常我们使用Tab按键或者打空格实现的缩进都只能缩进一小部分,这时可以通过占位符实现更多的缩进效果,使得文章变得美观

一个汉字占两个空格大小,所以使用四个空格就可以达到首行缩进两个汉字的效果。有如下几种方法:

  1. 一个空格大小的表示:  ,此时只要在相应需要缩进的段落前加上 4个 如上的标记即可,注意要带上分号
  2. 两个空格的大小表示:  ,同理,使用2个即可缩进2个汉字,推荐使用该方式
  3. 不换行空格:  ,使用4个 即可。

范例

不使用任何缩进效果

​ 使用Tab实现缩进

​ 在前面打上很多空格实现缩进

    使用4个 实现缩进

  使用2个 实现缩进

     使用4个 实现缩进

加粗指令不生效

  1. **注意:**这是一个指令不生效的演示

  2. *\c\d\f*

以上两种情况都会导致加粗不生效,前者怀疑是符号和加粗语句冲突了,后者斜杠和加粗语句冲突了

解决办法

  1. 不要把符号包括进去加粗,注意:这是一个加粗演示
  2. 后面空开一格(基本能解决大多数冲突),注意: 这是一个加粗演示
  3. 使用html语句来实现,用strong标签包裹