面向在本站写新文章的语法参考。所有行为均以当前版本(Hexo 8 + blanktime-desktop)实测为准,示例都经过构建验证。

由于本人之前使用 Volantis 主题,一些插件标签会采用类似使用语法。

1.文章头信息

source/_posts/ 下每篇文章以 YAML front matter 开头:
---
title: {{ title }} # 文章标题
date: {{ date }} # 创建日期
plugins: # 数学公式
- mathjax
author: η
published: ture # 是否发布文章,false 表示只保留但不生成。
# 多半需要修改
tags: 未指定标签 # 标签
category: 未指定分类 # 分类
headimg: 头图链接 # 头图链接
pin: false # true 时在博客文章列表置顶,false 时取消;不要加引号。
---

主题会读取的字段:

字段 作用
title 文章标题。
date 发布时间。
updated 更新时间。
tags 标签。
category 分类。
headimg 头图链接。
pin true 时置顶并显示标记;多篇置顶文章按发布时间倒序,其余文章也按发布时间倒序。
plugins 公式。
author 作者名称

2.文本修饰标签

效果

这是普通文本

这是斜体

这是粗体文本
这是带下划线文本

这是删除线文本写法1

这是删除线写法2

这是行内代码样式

这是一段默认隐藏的文本

键盘样式 Win + R

Ctrl + C,以及 Ctrl + V

源码

这是普通文本

*这是斜体*
**这是粗体文本**
<u>这是带下划线文本</u>

~~这是删除线文本写法1~~
<del>这是删除线写法2</del>

`这是行内代码样式`

{% psw 这是一段默认隐藏的文本 %}
{% kbd 键盘样式 %} {% kbd Win %} + {% kbd R %}
<kbd>Ctrl</kbd> + <kbd>C</kbd>,以及 <kbd>Ctrl</kbd> + <kbd>V</kbd>

3.tab

效果

这里是第一个栏目

这里是第一个栏目的内容

这里是第二个栏目

这里是第二个栏目的内容

tab源码

{% tabs id999 %}
<!-- tab 这里是第一个栏目 -->
这里是第一个栏目的内容
<!-- endtab -->
<!-- tab 这里是第二个栏目 -->
这里是第二个栏目的内容
<!-- endtab -->
{% endtabs %}

4.span

效果

红色文字

绿色文字

蓝色文字

源码

{% span red::红色文字 %}
{% span green::绿色文字 %}
{% span blue::蓝色文字 %}

参数

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

5.p

效果

红色文本 黄色文本 绿色文本 青色文本 蓝色文本 灰色文本

源码

{% p red::红色文本 %}
{% p yellow::黄色文本 %}
{% p green::绿色文本 %}
{% p cyan::青色文本 %}
{% p blue::蓝色文本 %}
{% p gray::灰色文本 %}

参数

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

6.note

效果

note warning 默认黄色,适合警告性的信息

源码

{% note warning::note warning 默认黄色,适合警告性的信息 %}

7.folding

效果

点击展开:旧主题的折叠标签
{% folding::点击展开:旧主题的折叠标签 %}

这里是这段folding的源码

{% endfolding %}

参数

参数位置可以填写颜色和状态,多个参数用空格隔开。

颜色 状态
blue, cyan, reen, yellow, red(未实现) open (默认打开)

效果

验证码Turnstilehttps://www.cloudflare.com/products/turnstile/

源码

{% link 验证码Turnstile::https://www.cloudflare.com/products/turnstile/::https://cf-assets.www.cloudflare.com/dzlvafdwdttg/69wNwfiY5mFmgpd9eQFW6j/d5131c08085a977aa70f19e7aada3fa9/1pixel-down__1_.svg %}

效果

源码

{% gallery::::one %}
![逸风城](https://)
![武陵城](https://)
![云汐城](https://)
![天星城](https://)
![广陵城](https://)
{% endgallery %}

10.timeline

效果

2020-06-06

“有缘再见,强尼。”

2020-05-15

“我是V,夜之城活着的传奇。”

2077-04-15

“无名小卒,还是名扬天下?”

源码

{% timeline %}

{% timenode 2020-06-06 %}

> “有缘再见,强尼。”

{% endtimenode %}

{% timenode 2020-05-15 %}

> “我是V,夜之城活着的传奇。”

{% endtimenode %}

{% timenode 2077-04-15 %}

> “无名小卒,还是名扬天下?”

{% endtimenode %}

{% endtimeline %}

11.image

效果

添加描述:

那条路.
那条路.

指定宽度:

指定宽度并添加描述:

没有什么故事。
没有什么故事。

设置占位背景色:

未实现
未实现

源码

{% image https://:: alt=那条路. %}
指定宽度:
{% image https://::width=500px %}
指定宽度并添加描述:
{% image https://::width=400px:: alt=没有什么故事。 %}
设置占位背景色:
{% image https://::width=300px::bg=#1D0C04:: alt=未实现 %}

参数

宽高 描述 占位背景色
width=300px::height=32px alt=描述 bg=#000