Obsidian Frontmatter 速查
最小可工作集
---
title: "标题"
date: 2026-06-10
publish: true
draft: false
---
四个字段就能让文章活起来。
常用字段
| 字段 | 类型 | 说明 |
|---|---|---|
title | string | 必填，文章标题 |
slug | string | URL 段，缺省用文件名 |
date | date | 2026-06-10 或 ISO 8601 |
publish | bool | 同步脚本读取这个判断是否发布 |
draft | bool | Hugo 读取这个，true 则不构建 |
categories | list | 分类，写中文或英文都行 |
tags | list | 标签 |
thumbnail | string | 封面图绝对路径 |
summary | string | 列表页摘要 |
反模式
1. 字段越多越"专业"吗？
不是。一个文章 6 个字段封顶。再多就是无用的元数据噪音。
2. categories 还是 tags？
categories：粗粒度，1-3 个。一个文章通常 1 个分类tags：细粒度，1-10 个。表达文章里的具体概念
3. slug 命名
- 短：1-3 个英文单词
- 全小写、连字符
- 不带日期——日期在 date 字段里
✅ hugo-deploy
❌ hugo-deploy-2026-06-10
❌ 如何在 Hugo 中部署我的静态博客
校验
部署前可以本地跑一次 hugo --printPathWarnings 看警告。如果有"找不到 template for taxonomy"之类，先看 frontmatter 有没有打错。
评论