写作

目录 一、快速开始 二、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 里的全局默认值。 ...

本文档列出本站支持的全部写作语法，每条都给出「写法」与「实际效果」对照，方便直接照着抄。 提示：右侧目录可快速跳转。 一、快速开始 新建文章（自动套用模板）： hugo new content posts/我的新文章.md 本地预览（写完保存自动刷新）： hugo server -D 推送发布（等价于原来 Hexo 的 hexo push）： ./push.sh # Git Bash push.bat # 或直接双击这个文件 二、Front Matter（文章头部配置） 写法： --- title: "文章标题" date: 2026-10-07T10:00:00+08:00 lastmod: 2026-10-07T10:00:00+08:00 draft: false description: "文章摘要，显示在列表页与搜索结果里" tags: ["标签一", "标签二"] categories: ["随笔"] keywords: ["关键词"] math: true # 开启数学公式 ShowToc: true # 显示目录 cover: image: "/images/cover/x.jpg" alt: "封面描述" caption: "封面说明" --- 说明：所有字段都可选，不写就用 hugo.yaml 里的全局默认值。draft: true 的文章不会发布。 三、文本与结构 3.1 标题 写法： ...