MarkDown是什么这里就不多说了,具体参考我的技术博客,同时这里推荐一下我的个人网站,使用的是hexo的butterfly主题:https://lovelijunyi.gitee.io/
了解文章目录
所有的文章都是放在主目录下source文件下的_posts目录下的,这里参考我的存放目录C:\Users\user\Desktop\lovelijunyi\source\_posts
这里作出两点说明:
- 该目录下可以再创建目录,系统可以识别到多层文件夹中的文章,方便分类
- 如果用命令生成的新文章一定是在_posts主目录下
熟悉操作指令
其实就是一句话,再把生成的文章拖到_posts目录下你自己创建的文件夹即可,文件后缀为.md
hexo n 你的文章名
Tips: 如果嫌麻烦,复制md文件再粘贴也是个好办法
开始书写文章
写MarkDown这里推荐Typora,非常好用,点开创建的文件,先看看里面有啥
---
title: typora-vue-theme主题介绍
date: 2018-09-07 09:25:00
---
两个虚线之间的内容就是叫Front-matter
,主要是你文章的配置,具体配置如下,这里不同主题不一样,我以Matery主题为例
Front-matter
选项中的所有内容均为非必填的。但我仍然建议至少填写 title
和 date
的值。
配置选项 | 默认值 | 描述 |
---|---|---|
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 中的一个 |
注意:
- 如果
img
属性不填写的话,文章特色图会根据文章标题的hashcode
的值取余,然后选取主题中对应的特色图片,从而达到让所有文章都的特色图各有特色。date
的值尽量保证每篇文章是唯一的,因为本主题中Gitalk
和Gitment
识别id
是通过date
的值来作为唯一标识的。- 如果要对文章设置阅读验证密码的功能,不仅要在 Front-matter 中设置采用了 SHA256 加密的 password 的值,还需要在主题的
_config.yml
中激活了配置。有些在线的 SHA256 加密的地址,可供你使用:开源中国在线工具、chahuo、站长工具。- 您可以在文章md文件的 front-matter 中指定 reprintPolicy 来给单个文章配置转载规则
以下为文章的 Front-matter
示例。
最全示例
---
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
,例如我的
---
# 标题
title: {{ title }}
date: {{ date }}
author: 无敌小小弋
# 简述
summary:
# 使用自定义封面
img:
# 是否置顶true,或者去掉
top: true
# 轮播
cover:
# 轮播图
coverImg:
# 标签
tags:
# 分类
categories:
# 是否加密文章,SHA256加密
password:
---
首行缩进方法
由于markdowm会自动限定格式,所以缩进显得比较困难,通常我们使用Tab按键或者打空格实现的缩进都只能缩进一小部分,这时可以通过占位符实现更多的缩进效果,使得文章变得美观
一个汉字占两个空格大小,所以使用四个空格就可以达到首行缩进两个汉字的效果。有如下几种方法:
- 一个空格大小的表示:
 
或 
,此时只要在相应需要缩进的段落前加上 4个 如上的标记即可,注意要带上分号。 - 两个空格的大小表示:
 
或 
,同理,使用2个即可缩进2个汉字,推荐使用该方式。 - 不换行空格:
或 
,使用4个 
即可。
范例
不使用任何缩进效果
使用Tab实现缩进
在前面打上很多空格实现缩进
使用4个 
实现缩进
使用2个 
实现缩进
使用4个 
实现缩进
加粗指令不生效
-
**注意:**这是一个指令不生效的演示
-
*\c\d\f*
以上两种情况都会导致加粗不生效,前者怀疑是符号和加粗语句冲突了,后者斜杠和加粗语句冲突了
解决办法
- 不要把符号包括进去加粗,注意:这是一个加粗演示
- 后面空开一格(基本能解决大多数冲突),注意: 这是一个加粗演示
- 使用html语句来实现,用strong标签包裹