一、Front-matter

front-matter
字段含义值类型备注
layout页面布局模版Stringpost,page,docs独立页面,文章页面,文档页面
title页面标题String-
seo_title网页标题Stringpage.title与 title 共同存在时,不显示标题
date创建时间Date文件创建时间
updated更新日期Date文件修改时间
link外部文章网址String-去源站阅读
music内部音乐控件[Object]-
keywords文章关键词String-
description文章摘要String-
top_meta是否显示 metaBooltrue顶部 meta 信息
bottom_meta是否显示 metaBooltrue底部 meta 信息
comments是否显示评论Booltrue
archive是否归档Booltrue是否出现在归档页,Post类型
sidebar页面侧边栏Bool, Arraysidebar.for_page/for_post手动指定侧边栏
mathjax是否渲染公式Boolfalse
thumbnail缩略图String-显示在文章页右上角
icons图标Array[]显示在归档页
pin是否置顶Boolfalse
headimg文章头图url-目前修改为只在列表页显示
indent是否首行缩进Boolfalse自定义修改:缩进 2 字符
references参考资料Array-{title: xxx, url: xxx}
copyright自定义文章版权[Object]-
showPostHeadimg是否显示文章头图Boolfalse
hiddenTitle显示文章标题Booltrue列表页(例如首页等)
http451区域化规则Boolfalse不适宜在境内开放的文章
background背景图String-文章页背景图
hidden是否隐藏文章Boolfalse基于插件支持
新建文章模板
新建文章模板
title: 文章名称 
seo_title: # 与 title 同时设定时隐藏文章页标题
hiddenTitle: true # 列表页是否显示标题
toc: true # 是否生成目录
indent: true # 是否首行缩进
comments: true # 是否允许评论
archive: true # 是否显示在归档
mathjax: false # 是否渲染公式
pin: false # 是否首页置顶
top_meta: false # 是否显示顶部信息
bottom_meta: false # 是否显示尾部信息
http451: false # 是否仅允许境外查阅文章
sidebar: [toc] # 指定侧边栏
hidden: false # 是否隐藏文章:列表、归档、RSS 等位置
tag:
- 标签一
- 标签二
categories: 分组
keywords: 文章关键词
date: 2021-13-13 00:00
updated: 2021-13-13 00:00
description: 文章摘要
icons: [fas fa-fire red, fas fa-star green]
thumbnail: https://文章右侧缩略图
background: https://文章背景图
headimg: https://文章头图
showPostHeadimg: true # 是否在文章页显示头图
references:
- title: 参考资料名称
url: https://参考资料地址
copyright:
type: type1 # 当前文章版权声明类型
author: 本文作者
ref:
title: 原文出处 - 标题
url: https://原文出处 - 链接

二、标签插件

1. 行内标签

text

下划线 的文本;带着重号的文本;带波浪线的文本;带 删除线 的文本

键盘样式的文本: + D

密码样式的文本:这里没有验证码

密文样式的文本:这里没有验证码

带 {% u 下划线 %} 的文本;带 {% emp 着重号 %} 的文本;带 {% wavy 波浪线 %} 的文本;带 {% del 删除线 %} 的文本 

键盘样式的文本:{% kbd ⌘ %} + {% kbd D %}

密码样式的文本:{% psw 这里没有验证码 %}

密文样式的文本:{% bb 真的没有啊喵, 这里没有验证码 %}
span

各种颜色的标签,包括:红色黄色绿色青色蓝色灰色

超大号文字:

A Wonderful Theme for Hexo

各种颜色的标签,包括:{% span red, 红色 %}、{% span yellow, 黄色 %}、{% span green, 绿色 %}、{% span cyan, 青色 %}、{% span blue, 蓝色 %}、{% span gray, 灰色 %}。 

超大号文字:

{% span center logo large, Volantis %}

{% span center small, A Wonderful Theme for Hexo %}

属性可选值
字体logo, code
颜色red, yellow, green, cyan, blue, gray
大小small, h4, h3, h2, h1, large, huge, ultra
对齐方向left, center, right
p

A Wonderful Theme for Hexo

{% p center logo large, Volantis %} 
{% p center small, A Wonderful Theme for Hexo %}

“与 span 参数相同”

上文所对应源码
<p class="p center logo large"><em>Volantis 主题用户手册 <sup>自用</sup></em></p>

2. 增强功能

时间线 timeline

timeline

时间线标题(可选)

时间节点(标题)

正文内容

时间节点(标题)

正文内容

最后更新于 3.0 版本
{% timeline 时间线标题(可选) %} 

{% timenode 时间节点(标题) %}

正文内容

{% endtimenode %}

{% timenode 时间节点(标题) %}

正文内容

{% endtimenode %}

{% endtimeline %}
一个自制时间线(标题可选)
  • 2021/13/32 巴啦啦小魔仙。
  • 2021/13/16 好好学习,天天向上。
  • 2021/13/15 风声雨声读书声声声入耳,国事家事天下事事事关心。
  • 2021/13/10 楼主以屎,有事烧纸。
  • 2021/13/08 那么就可以有星期八了。
  • 2021/13/01 是的没错,这里是 13 月。
  • 这里是时间线的起点~
自制标签
{% timelines '一个自制时间线(标题可选)' %} 

{% timenodes fal fa-bat %} 2021/13/32 巴啦啦小魔仙。{% endtimenodes %}
{% timenodes fal fa-glass-cheers %} 2021/13/16 好好学习,天天向上。 {% endtimenodes %}
{% timenodes fal fa-genderless %} 2021/13/15 风声雨声读书声声声入耳,国事家事天下事事事关心。 {% endtimenodes %}
{% timenodes fal fa-narwhal %} 2021/13/10 楼主以屎,有事烧纸。 {% endtimenodes %}
{% timenodes fal fa-genderless %} 2021/13/08 那么就可以有星期八了。 {% endtimenodes %}
{% timenodes fal fa-genderless %} 2021/13/01 是的没错,这里是 13 月。 {% endtimenodes %}
{% timenodes fal fa-fan fa-spin %}这里是时间线的起点~{% endtimenodes %}

{% endtimelines %}

引用块 note/blocknote

note/blocknote

blocknotenote 多出了显示标题的能力

《寻隐者不遇》

松下问童子,言师采药去。
只在此山中,云深不知处。

三、表情包

emoji
代码效果代码效果代码效果
{% emoji youling %} 幽灵{% emoji bizui %} 闭嘴{% emoji baiyan %} 白眼
{% emoji aixin %} 爱心{% emoji dajing %} 大惊{% emoji ziya %} 呲牙
{% emoji daxiao %} 大笑{% emoji esi %} 饿死{% emoji fadai %} 发呆
{% emoji fankun %} 犯困{% emoji ganga %} 尴尬{% emoji fennu %} 愤怒
{% emoji hanyan %} 汗颜{% emoji guaiwu %} 怪物{% emoji haochi %} 好吃
{% emoji emo %} 恶魔{% emoji renzhe %} 忍者{% emoji jingya %} 惊讶
{% emoji kaixin %} 开心{% emoji lengku %} 冷酷{% emoji danao %} 大闹
{% emoji feiwen %} 飞吻{% emoji liulei %} 流泪{% emoji mengbi %} 懵逼
{% emoji bianbian %} 便便{% emoji nanguo %} 难过{% emoji shuizhuo %} 睡着
{% emoji xiaochulei %} 笑哭{% emoji jingkong %} 惊恐{% emoji santiaoxian %} 尴尬
{% emoji tiaopi %} 调皮{% emoji ganmao %} 感冒{% emoji wuliao %} 无聊
{% emoji fankun1 %} 犯困{% emoji xieyan %} 斜眼{% emoji xiasi %} 吓死
{% emoji xiaolian %} 笑脸{% emoji huaixiao %} 坏笑{% emoji shengqi %} 生气
{% emoji liuhan %} 流汗{% emoji outu %} 呕吐{% emoji keshui %} 瞌睡
{% emoji tianshi %} 天使{% emoji xianwen %} 献吻{% emoji yiwen %} 疑问
{% emoji shimo %} 什么{% emoji dianzan %} 点赞{% emoji biti %} 鼻涕
{% emoji fendou %} 奋斗{% emoji huqi %} 呼气{% emoji kulou %} 骷髅
{% emoji tanchi %} 贪吃{% emoji shuixing %} 睡醒{% emoji aini %} 爱你
{% emoji aixin1 %} 爱心{% emoji zhadan %} 炸弹{% emoji xinsui %} 心碎
{% emoji maren %} 骂人{% emoji zhutou %} 猪头{% emoji qie %} 企鹅
{% emoji shoushang %} 受伤{% emoji jingsong %} 惊悚{% emoji taoyan %} 讨厌
代码效果代码效果代码效果
{% emoji mianwubiaoqing %} 面无表情{% emoji bushufu %} 不舒服{% emoji ku %}
{% emoji xiaodiaodaya %} 笑掉大牙{% emoji yousiliao %} 又死了{% emoji yun %}
{% emoji siliao %} 去死了{% emoji liubixie %} 流鼻血{% emoji xiong %}
{% emoji taoyan1 %} 讨厌啦{% emoji en %}{% emoji leng %}
{% emoji xingxingyan %} 星星眼{% emoji a %}
{% emoji liukoushui %} 流口水