参考

目录 一、快速开始 二、Front Matter 完全指南 三、Markdown 基础语法 四、PaperMod 主题短代码 五、Hugo 内置短代码 六、本站增强语法 七、写作工具与工作流 八、实战：完整文章示例 九、常见坑与排查 十、速查表 一、快速开始 1.1 三个命令 hugo new content posts/我的新文章.md # 新建文章（自动套用 archetypes/default.md 模板） hugo server -D # 本地预览（-D 表示包含草稿），打开 http://localhost:1313 hugo --gc --minify # 构建发布（产物在 public/ 目录） 1.2 一篇文章的最小结构 --- title: "文章标题" date: 2026-10-07T10:00:00+08:00 draft: false tags: ["标签1", "标签2"] categories: ["分类"] --- 正文从这里开始。 1.3 写作流程建议 hugo new content posts/xxx.md 新建（默认 draft: true） 写内容，浏览器开着 hugo server -D 实时预览 写完把 draft 改为 false hugo --gc --minify 构建，把 public/ 部署到托管平台 二、Front Matter 完全指南 Front matter 是文章头部的 YAML 配置块（--- 包裹）。所有字段都是可选的，不写的字段会使用 hugo.yaml 里的全局默认值。 ...