MarkDown是什么这里就不多说了,具体参考我的技术博客,同时这里推荐一下我的个人网站,使用的是hexo的butterfly主题:https://lovelijunyi.gitee.io/

了解文章目录

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

这里作出两点说明:

  1. 该目录下可以再创建目录,系统可以识别到多层文件夹中的文章,方便分类
  2. 如果用命令生成的新文章一定是在_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 选项中的所有内容均为非必填的。但我仍然建议至少填写 titledate 的值。

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

最全示例

---
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按键或者打空格实现的缩进都只能缩进一小部分,这时可以通过占位符实现更多的缩进效果,使得文章变得美观

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

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

不使用任何缩进效果

​ 使用Tab实现缩进

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

    使用4个 实现缩进

  使用2个 实现缩进

     使用4个 实现缩进

加粗指令不生效

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

  2. *\c\d\f*

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

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

开放原子开发者工作坊旨在鼓励更多人参与开源活动,与志同道合的开发者们相互交流开发经验、分享开发心得、获取前沿技术趋势。工作坊有多种形式的开发者活动,如meetup、训练营等,主打技术交流,干货满满,真诚地邀请各位开发者共同参与!

更多推荐