高级功能文档

Hexo + Fluid 配置

Fluid Docs

Hexo Docs

本项目Github Repo

---

如何为本项目做贡献?

1. fork本项目
2. 安装环境

git clone https://github.com/{your_user_name}/mowan.git

cd mowan

npm install -g hexo

hexo server

3. 使用诸如[Add] [Docs]的前缀提交
4. 发起PR

---

项目Docs

1. 使用hexo new post --path categorie\name "Name“
2. 修改Front-matter
3. 对于能使用Tag Func实现的内容，请不要注入全局JS
4. 不接受Vibe Coding产物

---

项目当前Tag Funcs

便签

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

{% note success %}
文字 或者 `markdown` 均可
{% endnote %}

可选便签：

primary

secondary

success

danger

warning

info

light

使用时 {% note primary %}` 和 `{% endnote %} 需单独一行，否则会出现问题

行内标签

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

{% label primary @text %}

可选 Label：

text text text text text text

折叠块

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

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

info: 和行内标签类似的可选参数

title: 折叠块上的标题

勾选框

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

{% cb text, checked?, incline?, disabled? %}

text：显示的文字

checked：默认是否已勾选，默认 false

incline: 是否内联（可以理解为后面的文字是否换行），默认 false disabled: 勾选框是否为不可点击的样式，默认 false

示例：

普通示例

默认选中

内联示例 后面文字不换行 也可以只传入一个参数，文字写在后边（这样不支持外联）

不可点击的样式

按钮

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

{% btn url, text, title? %}
或者使用 HTML 形式：

url：跳转链接
text：显示的文字
title：鼠标悬停时显示的文字（可选）

text

组图

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

{% gi total n1-n2-... %}
{% endgi %}

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

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

计时器

{% day_counter name time %}

{% day_counter_loader %}

name: 任意字符串

time: 形如2026-03-01[ 18:32:11]的形式

单页只能有一个{% day_counter_loader %}

计时器1 距离现在时间:

计时器2 距离现在时间:

计时器3 距离现在时间: