内容创作指南

1hugo-teek-site/content/
2├── docs/               # 文档类内容
3│   ├── hugo-teek默认文档/
4│   └── 专题/
5├── posts/              # 博客文章
6├── about/              # 关于页面
7└── _settings/          # 设置页面

1技术文档 → content/docs/分类名/
2博客随笔 → content/posts/
3个人介绍 → content/about/

 1---
 2title: 文章标题
 3date: "2026-03-02T10:00:00+08:00"
 4description: "文章描述"
 5tags:
 6    - 标签1
 7    - 标签2
 8categories:
 9    - 分类名
10draft: false
11---

 1---
 2title: 文章标题                          # 文章标题
 3date: "2026-03-02T10:00:00+08:00"       # 发布时间
 4description: "文章描述"                  # SEO描述
 5coverImg: https://example.com/img.jpg   # 封面图片
 6url: /custom-path                        # 自定义URL
 7weight: 1                                # 排序权重
 8tags:                                    # 标签列表
 9    - 标签1
10    - 标签2
11categories:                              # 分类列表
12    - 分类名
13draft: false                             # 草稿状态
14featured: true                           # 首页推荐
15---

 1# 文章标题
 2
 3## 简介
 4简要介绍文章主题
 5
 6## 环境准备
 7需要的工具和依赖
 8
 9## 详细步骤
101. 步骤一
112. 步骤二
123. 步骤三
13
14## 常见问题
15Q1: 问题描述？
16A: 解决方案
17
18## 总结
19总结要点

 1# 文章标题
 2
 3## 背景
 4为什么写这篇文章
 5
 6## 正文内容
 7详细叙述...
 8
 9## 心得体会
10个人感悟...
11
12## 参考资料
13相关链接...

1tags:
2    - hugo
3    - 前端开发
4    - 静态网站
5    - 教程

1tags:
2    - 随笔
3    - 读书笔记
4    - 生活感悟

1tags:
2    - 开源项目
3    - 工具推荐
4    - 使用心得

1优点：不占用仓库空间，加载速度快
2推荐：阿里云OSS、腾讯云COS、GitHub图床

1优点：资源可控，不依赖外部服务
2路径：hugo-teek-site/static/images/
3引用：/images/xxx.jpg

1优点：全球加速，访问稳定
2推荐：Cloudflare、jsDelivr

1![图片描述](https://example.com/image.jpg)

1<img src="https://example.com/image.jpg" alt="图片描述" width="80%">

1<figure>
2  <img src="/images/example.jpg" alt="示例">
3  <figcaption>图片标题说明</figcaption>
4</figure>

1---
2title: "包含关键词的标题"
3description: "150字以内的描述，包含核心关键词"
4url: /seo-friendly-url
5---

 1# 文章标题包含核心关键词
 2
 3## 第一段要包含关键词
 4文章开头100字内出现核心关键词...
 5
 6## 合理使用小标题
 7使用H2、H3标签组织内容结构...
 8
 9## 添加内部链接
10参考[相关文章](/other-post/)...
11
12## 图片添加Alt属性
13![关键词描述](image.jpg)

1make dev
2# 访问 http://localhost:9090 预览

1make quick
2# 跳过搜索索引，快速启动

1make fix-frontmatter
2# 自动修复缺失的Front Matter

1❌ 避免：
2一大段文字没有分段，读起来很累...
3
4✅ 推荐：
5每段控制在3-5行。
6
7适当分段让阅读更轻松。
8
9使用空行分隔不同主题。

1❌ 避免：
2第一点是什么，第二点是什么，第三点是什么...
3
4✅ 推荐：
5- 第一点说明
6- 第二点说明
7- 第三点说明

1使用 **加粗** 突出重点
2使用 `代码` 标记技术术语
3使用 > 引用重要内容

1检查：
21. draft 是否为 false
32. date 是否为未来时间
43. 文件是否在正确的 content 目录下

1解决：
21. 检查 weight 字段设置
32. weight 数字越小越靠前
43. 相同weight按时间排序

1注意：
21. tags 使用数组格式
32. 注意缩进使用空格
43. 避免特殊字符