博客文章页高级说明

文章 front-matter 说明

1
2
3
4
5
6
7
8
9
10
title: 标题
excerpt: 摘要
index_img: 首页封面图
banner_img: 文章页 banner 图
hide: false # 是否隐藏
archive: true # 隐藏文件在归档中也能看见，hide 不能设置为 true，否则仍不可见
sticky: 1 # 是否置顶（数字越大越靠前）
comment: 'valine' # 是否开启评论（false/true,或者具体的评论插件：valine/waline）
abbrlink: 2268ade3 # 文章页永链
date: 2019-10-10 10:00:00 # 日期

脚注

主题内置了脚注语法支持，可以在文章末尾自动生成带有锚点的脚注，该功能在主题配置中默认开启：

1
2
3
4
post:
  footnote:
    enable: true
    header: ""

脚注语法如下：

1
2
这是一句话[^1]
[^1]: 这是对应的脚注

更优雅的使用方式，是将脚注写在文末，比如：

1
2
3
4
5
6
正文

## 参考

[^1]: 参考资料 1
[^2]: 参考资料 2

当然你也可以通过修改上方配置项 header 来自动加入节标题，如下所示：

1
2
3
4
post:
  footnote:
    enable: true
    header: "<h2>参考</h2>" # 等同于手动写 `## 参考`

Tag 插件

可选标签：
<p class="note note-primary">primary</p> 或 {% note primary %} primary {% endnote %}
可选 label：

  • primary
  • secondary
  • default
  • info
  • success
  • warning
  • danger

行内标签

<span class="label label-primary">text</span> 或 {% label secondary @text %}
可选 label：

  • primary
  • default
  • info
  • success
  • warning
  • danger

折叠块

使用折叠块，可以折叠代码、图片、文字等任何内容，你可以在 markdown 中按如下格式：

1
2
3
{% fold info @title %}
需要折叠的一段内容，支持 markdown
{% endfold %}

info: 和行内标签类似的可选参数 title: 折叠块上的标题

勾选框

在 markdown 中加入如下的代码来使用 Checkbox：

1
{% cb text, checked?, incline? %}
  • text：显示的文字
  • checked：默认是否已勾选，默认 false
  • incline: 是否内联（可以理解为后面的文字是否换行），默认 false

按钮

你可以在 markdown 中加入如下的代码来使用 Button：

1
{% btn url, text, title %}

或者使用 HTML 形式：

1
<a class="btn" href="url" title="title">text</a>
  • url：跳转链接
  • text：显示的文字
  • title：鼠标悬停时显示的文字（可选）

组图

如果想把多张图片按一定布局组合显示，你可以在 markdown 中按如下格式：

1
2
3
4
5
6
7
{% gi total n1-n2-... %}
![](url)
![](url)
![](url)
![](url)
![](url)
{% endgi %}

total：图片总数量，对应中间包含的图片 url 数量
n1-n2-...：每行的图片数量，可以省略，默认单行最多 3 张图，求和必须相等于 total，否则按默认样式

例如：{% gi 5 3-2 %} 示例，代表共 5 张图，第一行 3 张图，第二行 2 张图。

blog > hexo
#博客
博客文章页高级说明
https://blog.echo-silence.top/posts/2268ade3.html
作者
极客奶爸
发布于
2025年3月16日
许可协议