从这里开始

第一篇示例文章。顺便把文章的写法、两种可见性、以及日常流程都讲清楚,以后照着改就行。

这是一篇示例文章,用来验证站点能正常构建。你可以删掉它,也可以直接改成自己的第一篇。

右侧栏那个随滚动高亮的分层目录,就是由下面这些标题自动生成的。

一、每篇文章顶部的元信息

开头两个 --- 之间的部分叫 front matter:

字段作用
title文章标题
description列表页和搜索引擎显示的摘要
date发布时间。不要填未来时间
tags / categories标签与分类,会自动生成对应页面
drafttrue 表示草稿,只有预览时可见
comments是否允许评论(需先在配置里开启 giscus)
image封面图,放在同目录下写文件名即可

目录是怎么来的

Hugo 会自动抓取正文里 ## 到 #### 的标题,生成层级目录:

  • ## 一级标题
  • ### 二级标题,会缩进嵌在上一级里面
  • #### 三级标题,再嵌一层

右侧栏的目录会跟随页面滚动自动高亮当前所在的小节,就是 Word 导航窗格那种感觉。

二、正文语法

代码块

带语言标记会自动高亮,右上角有复制按钮:

export function greet(name) {
  return `你好,${name}`;
}

图片

把图片放进 static/images/,然后这样引用:

![图片说明](/images/example.png)

提示框

主题内置了五种提示框,用引用块加标记即可:

📝 备注

这是一条备注。

💡 提示

这是一条提示。

⚠️ 警告

这是一条警告。

表格与清单

上面已经演示过表格。清单:

  • 无序清单
  • 支持嵌套
    • 像这样
  1. 有序清单
  2. 第二项

第四级标题也会进目录

目录默认抓到第四级(####),所以更细的小节也能被定位到。 你看到的这个「第四级标题也会进目录」就是第三层级的条目。

三、两种可见性

这是本站和普通博客最大的不同 —— 文章有两种状态:

状态放哪个目录谁能看到
公开content/post/所有人、搜索引擎
私密content-private/post/只有你(或被你在 Cloudflare 里授权的邮箱)

两种文章都写 Markdown,写法完全一样,区别只在放哪个目录。

为什么用两个目录而不是一个开关? 因为公开站构建时使用的 content/ 目录里根本不存在私密文件 —— 不存在"忘了过滤结果泄露"的可能。这比用 draft 标记或者模板判断要可靠得多。

私密文章需要单独构建、单独部署,详见 DEPLOY.md。

四、日常流程

  1. 双击 新文章.bat(私密文章用 新私密文章.bat),输入英文文件名
  2. 用编辑器打开生成的文件开始写
  3. 双击 预览.bat 在浏览器里看效果,改字自动刷新
  4. 满意后把 draft 改成 false
  5. 双击 构建.bat,把生成的 public/ 上传到 Cloudflare Pages

就这样。没有数据库、没有后台、没有登录,写完就是几个 Markdown 文件。