（一）新建一篇文章文件

每次想写新博客时，第一步就是让系统帮你生成一个空文件。

打开你的命令行（PowerShell）。

复制并运行这段代码（注意替换为你自己的文章名，比如 my-first-post）：

1"E:\hugo\dev\hugo.exe" new content blog/mynewpost.md

运行后，系统会在 content/blog/ 文件夹里生成一个叫 mynewpost.md 的文件。

（二）填写文章的前言部分

需要用 --- 包夹

• title【标题】
• date 【发布时间】
• draft 【发布与草稿】false为发布，true为草稿
• slug 【网站】建议纯英文
• tags 【标签】
• description【页面描述】

注意：--- 上下两段之间的内容就是 Front Matter。不要随便删掉。

（三）写正文内容

在第二个 --- 的下面就是正文部分了

（四）边写边看（本地预览）

对于新手来说，格式容易写着写着就乱了，这部分就很合适随时看网页效果

1.在PowerShell 里运行这段启动命令

1hugo server -D

2.打开浏览器，输入 http://localhost:1313 就可以看到保存的内容

（五）完整示例：一篇文章的基本结构

前面介绍了各个步骤，下面把文章信息和正文放在一起，看看一篇完整的文章应该怎么写。

打开刚才新建的 content/blog/mynewpost.md，用下面的内容替换文件里的内容，再改成自己的标题、日期和正文。

文章文件示例

 1---
 2title: "我的第一篇博客"
 3date: 2026-05-19T00:00:00+08:00
 4draft: false
 5slug: "my-first-post"
 6tags: ["教程"]
 7description: "记录第一次使用 Hugo 写博客的过程。"
 8---
 9
10## 正文部分
11
12这是我的第一篇博客，可以用 **加粗文字** 标出重点。
13
14- 新建文章文件
15- 填写文章信息
16- 写正文并预览
17
18## 结尾
19
20保存文件后，回到浏览器查看效果。

这个例子怎么看？

• 文章信息：前两个 --- 之间是 Front Matter，用来填写标题、日期、标签等信息。
• 正文内容：第二个 --- 之后是正文，可以写段落、标题和列表。
• 显示效果：正文会显示为两个二级标题、一段带加粗的文字、一份三项列表和一段结尾；##、** 和列表行开头的 - 会转换成对应的格式。

注意：## 后面要留一个空格，例如 ## 正文部分。标题、段落和列表之间留一个空行，结构会更清楚，也方便以后修改。

保存文件后，在已启动的本地预览页面查看效果，再试着改一改文字，就能熟悉这些格式了。