这是一篇示例文章,用来验证站点能正常构建。你可以删掉它,也可以直接改成自己的第一篇。
右侧栏那个随滚动高亮的分层目录,就是由下面这些标题自动生成的。
一、每篇文章顶部的元信息
开头两个 --- 之间的部分叫 front matter:
| 字段 | 作用 |
|---|---|
title | 文章标题 |
description | 列表页和搜索引擎显示的摘要 |
date | 发布时间。不要填未来时间 |
tags / categories | 标签与分类,会自动生成对应页面 |
draft | true 表示草稿,只有预览时可见 |
comments | 是否允许评论(需先在配置里开启 giscus) |
image | 封面图,放在同目录下写文件名即可 |
目录是怎么来的
Hugo 会自动抓取正文里 ## 到 #### 的标题,生成层级目录:
##一级标题###二级标题,会缩进嵌在上一级里面####三级标题,再嵌一层
右侧栏的目录会跟随页面滚动自动高亮当前所在的小节,就是 Word 导航窗格那种感觉。
二、正文语法
代码块
带语言标记会自动高亮,右上角有复制按钮:
export function greet(name) {
return `你好,${name}`;
}
图片
把图片放进 static/images/,然后这样引用:

提示框
主题内置了五种提示框,用引用块加标记即可:
备注这是一条备注。
提示这是一条提示。
警告这是一条警告。
表格与清单
上面已经演示过表格。清单:
- 无序清单
- 支持嵌套
- 像这样
- 有序清单
- 第二项
第四级标题也会进目录
目录默认抓到第四级(####),所以更细的小节也能被定位到。
你看到的这个「第四级标题也会进目录」就是第三层级的条目。
三、两种可见性
这是本站和普通博客最大的不同 —— 文章有两种状态:
| 状态 | 放哪个目录 | 谁能看到 |
|---|---|---|
| 公开 | content/post/ | 所有人、搜索引擎 |
| 私密 | content-private/post/ | 只有你(或被你在 Cloudflare 里授权的邮箱) |
两种文章都写 Markdown,写法完全一样,区别只在放哪个目录。
为什么用两个目录而不是一个开关?
因为公开站构建时使用的 content/ 目录里根本不存在私密文件 ——
不存在"忘了过滤结果泄露"的可能。这比用 draft 标记或者模板判断要可靠得多。
私密文章需要单独构建、单独部署,详见 DEPLOY.md。
四、日常流程
- 双击
新文章.bat(私密文章用新私密文章.bat),输入英文文件名 - 用编辑器打开生成的文件开始写
- 双击
预览.bat在浏览器里看效果,改字自动刷新 - 满意后把
draft改成false - 双击
构建.bat,把生成的public/上传到 Cloudflare Pages
就这样。没有数据库、没有后台、没有登录,写完就是几个 Markdown 文件。