让 Markdown 负责内容

为这个小站整理内容时,选择了按文件保存文章的方式。每篇记录独立放在内容目录里,文件名也就是文章地址的一部分。

一篇记录的组成

文件开头是少量信息,后面是普通 Markdown 正文。标题和日期交给页面模板显示,正文从段落或二级标题开始写即可。

title: 一次小调整
description: 用一两句话介绍这次调整。
date: 2026-11-08

description 用作文章页面的描述信息。文章列表只列出标题,具体内容在打开文章后再显示。

写好再发布

暂时没有完成的文字可以标记为草稿。构建时会过滤草稿,既不放进首页列表,也不生成可以访问的文章页面。

文件名尽量在发布前确定。后续修改标题不会改变地址,但修改文件名会产生一个新地址,因此尽量保持已经发布的文件名不变。

够用的目录结构

当前所有记录放在同一个目录里,文章列表按日期排序,最多展示五篇。文章数量较少时,这样就足够了,暂时没有增加分类和标签页面。