1
2
3
4
5

---
title: "心清如水"           # 文章标题（必填）
description: ""            # 文章描述/摘要（SEO重要）
date: 2025-10-21T18:48:36+08:00  # 创建时间（自动生成）
---

1
2
3

image: ""                  # 文章特色图片路径
# 示例: image: "/images/featured.jpg"
# 示例: image: "https://example.com/image.jpg"

1
2
3
4
5

math: false                # 是否启用数学公式渲染（KaTeX）
license: ""                # 版权声明（如："CC BY-NC-ND 4.0"）
hidden: false              # 是否在列表中隐藏（但仍可直接访问）
comments: true             # 是否启用评论系统
draft: true                # 是否为草稿模式（重要！）

1
2

draft: true    # 草稿：不会在正式构建中发布
draft: false   # 正式：会发布到网站

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

# 默认不构建草稿
hugo

# 构建包含草稿
hugo --buildDrafts
# 或
hugo -D

# 开发服务器查看草稿
hugo server -D

1
2
3

# 控制文章排序和发布
date: 2025-10-21T18:48:36+08:00  # 精确到秒
date: 2025-10-21                 # 只到日期

1
2

categories: ["技术", "Hugo"]
tags: ["前端", "静态网站", "教程"]

1
2

author: "你的名字"
authors: ["作者1", "作者2"]

1
2
3
4

params:
  featured_image: "/images/cover.jpg"
  reading_time: true  # 显示阅读时间
  toc: true          # 显示目录

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

---
title: "Hugo Front Matter 详解"
description: "全面解析 Hugo 文章元数据的各项属性"
date: 2025-10-21T18:48:36+08:00
image: "/images/hugo-frontmatter.jpg"
math: false
license: "CC BY-NC-SA 4.0"
hidden: false
comments: true
draft: false
categories: ["技术", "博客"]
tags: ["Hugo", "Front Matter", "教程"]
author: "你的名字"
params:
  toc: true
  reading_time: true
---

1
2
3

title:    # 必须有标题
date:     # 必须有日期（Hugo自动生成）
draft:    # 明确是否为草稿

1
2

description: "50-160字符的吸引人描述"
image: "高质量的特色图片"

1
2

categories: ["大类"]     # 1-2个主要分类
tags: ["关键词1", "关键词2"]  # 5-10个相关标签

1
2
3
4

---
title: "示例"
draft: true
---

1
2
3
4

+++
title = "示例"
draft = true
+++

1
2
3
4

{
  "title": "示例",
  "draft": true
}

1
2
3
4
5
6
7
8

# 构建正式版本（不含草稿）
hugo

# 构建包含草稿
hugo -D

# 实时预览（含草稿）
hugo server -D