Kuan：中文优先的Hugo主题

Thu, 08 Oct 2026 00:00:00 +0000

Kuan 是一款为中文写作和阅读设计的 Hugo 主题，适合个人博客、专栏和长文站点。你可以查看示例站点。

六种主题配色、浅色/深色/跟随系统显示模式。
文章目录、进度提示、图片灯箱、封面、代码高亮、全屏阅读和记住阅读位置。
可选的自定义字体、KaTeX 数学公式和 Giscus 评论。
长文、短文与含图文章筛选，可切换内容导航与形式导航。

GlimpseContent：干净的目录插件

Tue, 06 Oct 2026 00:00:00 +0000

我把本站左下角的目录功能整理成了 GlimpseContent。平时是一列小横杠，按需显示标题。你可以查看排版样例。

只需一份 JavaScript 和 CSS。
只列二、三级标题；悬停显示对应标题，滚动时高亮。
默认在页面宽度超过 800px、文章全部标题合计超过 5 个时显示。
页面完整加载后淡入，支持深色模式和减少动画偏好。
点击平滑跳转；容器、页眉和显示阈值都可以配置。

一次随手的记录

Mon, 05 Oct 2026 00:00:00 +0000

今天打开窗户，发现风把桌上的纸吹到了另一边。于是把杯子压在纸上，继续做手里的事。

网站也在一点点调整。先让页面能够打开，再慢慢写下想说的话。暂时没有特别完整的计划，就从这一小段文字开始。

title: 一次随手的记录
date: 2026-10-05
typora-root-url: ./

记下三个小事

喝了一杯温水。
整理了桌面。
给网站添了一篇文章。

明天如果想到新的内容，再回来补几句。

文字的轻重与停顿

普通文字负责把事情说清楚，加粗文字负责强调重点，斜体文字适合补充说明。也可以组合成粗斜体，或用~~删除线~~留下修改的痕迹。

这一句之后有一个手动换行。
下一句仍在同一个段落里。

一个三级标题

小标题用来划分话题，不必把每个短段落都拆成新的章节。

一个四级标题

更细的层级可以留给附属内容。

一个五级标题

例如，一条简短的补充说明。

一个六级标题

这也是标题，不过日常文章通常用不到这么深的层级。

列表、顺序与待办事项

无序列表可以包含下一层内容：

阅读
- 一本书里的一个章节
- 一篇没有来得及读完的文章
记录
- 一个新想法
- 一段值得保留的文字

有些事情则更适合按顺序写：

打开窗户，让房间透透气。
清理桌面，只留下正在用的东西。
写下今天最想记住的一件小事。

待办清单不必每一项都立刻完成：

给网站写一篇样例文章
加入公式和图片
下一次再补几段真实的记录

一段引用

简约不是把内容删到什么都不剩，而是让每一处内容都能被自然地阅读。

留白让句子之间有一点呼吸的空间。

引用中也可以再引用一小段话，但不必嵌套得太深。

用表格整理一周

下面的数据只是虚构的排版示例，不代表真实记录。

日期	阅读时间（分钟）	随手记下的内容
周一	5	一句话
周二	8	两个小问题
周三	7	一段摘录
周四	12	一个新的想法
周五	15	一页笔记
合计	47	五天的小积累

Markdown: 一种以纯文本书写标题、列表、链接等内容的格式。
LaTeX: 本文公式使用的数学标记语法。

让公式走进正文

行内公式可以自然地放在句子中，比如 $E = mc^2$，或者用另一种定界符写成 $a^2 + b^2 = c^2$。

独立公式适合展示稍长的表达式：

$$ \int_0^1 x^2\,dx = \left[\frac{x^3}{3}\right]_0^1 = \frac{1}{3} $$

矩阵也可以单独显示：

\[ A = \begin{pmatrix} 1 & 2 \\ 3 & 4 \end{pmatrix}, \qquad \det(A) = 1 \times 4 - 2 \times 3 = -2 \]

下面用多行公式计算表格中的平均阅读时间：

$$ \begin{aligned} T &= 5 + 8 + 7 + 12 + 15 = 47 \\ \bar{t} &= \frac{T}{5} = 9.4\text{ 分钟} \end{aligned} $$

代码也需要一点留白

一段 Python 代码，可以得到同样的结果：

minutes = [5, 8, 7, 12, 15]

total = sum(minutes)
average = total / len(minutes)

print(f"总时长：{total} 分钟")
print(f"平均每天：{average:.1f} 分钟")

换一种语言，语法高亮也会跟着变化：

const minutes = [5, 8, 7, 12, 15];
const total = minutes.reduce((sum, value) => sum + value, 0);

console.log({
 total,
 average: total / minutes.length
});

没有语言标记的文本块，则按原样显示。代码里的美元符号不会被当作公式：

$这是一段原样保留的文本$
第一行：阅读
第二行：记录
第三行：整理

单张图片

下面使用你上传的图片作为示例。单张图片保持原始比例，并随文章宽度缩放。

两张图片放在同一个段落

两张图片连续写在同一段落里，会并排展示。这里重复使用同一张照片，仅用于演示排版。

五张图片放在同一个段落

五张图片同样连续写在一个段落里，中间不空行：

桌面会排成三张加两张；屏幕变窄时，列数会自动减少。所有图片保留原始比例。

留一点补充说明

脚注可以把次要的说明留到文章末尾，避免打断正文。¹

格式是为了方便阅读。把需要的内容写清楚，再让标题、段落、图片和公式各自找到合适的位置。

这篇文章用于展示 Markdown 排版。表格中的阅读数据为虚构示例，图片使用上传的示例照片。 ↩︎

友情链接

希记：做一条，逆流的鱼。

睿朗的小窝：睿朗的个人网站

路明笔记：一名高中生的技术与生活博客

添加或删除

请通过 z603zz@outlook.com 告知我。


标题	KuanZZZ
描述	一名生物学本科生，分享我的研究和问题。
头像	https://kuanzzz.pages.dev/favicon.ico
RSS	https://kuanzzz.pages.dev/index.xml
文章 RSS	https://kuanzzz.pages.dev/rss.xml

单向状态

阿锋的小宇宙：沧海一粟，微亮而渺小。

Blank的博客：Blank的个人博客，记录分享自己的工作生活

KuanZZZ