1. Hexo 文章的基本结构

你写的文章文件一般是这样开头的：

1
2
3
4
5
6
7

---
title: 我的第一篇博客
date: 2026-05-28 12:00:00
tags:
- Hexo
- 教程
---

这部分叫“Front-matter”，Hexo 用它来识别文章标题、时间、标签等信息。

Front-matter 后面，就是正文内容，用 Markdown 写。

2. 常用 Markdown 语法

标题

1
2
3

# 一级标题
## 二级标题
### 三级标题

段落

直接写一句话，空一行就是新段落：

1
2
3

这是第一段。

这是第二段。

加粗 / 斜体

1
2

**加粗**
*斜体*

链接

1

[Hexo 官网](https://hexo.io/)

图片

1

![描述文字](/images/avatar.gif)

列表

无序列表：

1
2

- 第一项
- 第二项

有序列表：

1
2

1. 第一项
2. 第二项

代码

单行代码：

1

`hexo new post "标题"`

多行代码块：

1
2

```bash
hexo server

1
2
3
4

### 引用
```md
> 这是一个引用

分割线

1

---

3. 结合 hello-world.md 的例子

你的 hello-world.md 其实就是标准写法：

• 开头只有 title
• 然后正文直接写文字
• 里面用了链接 [Hexo](https://hexo.io/)
• 还用了标题 ## Quick Start、### Create a new post
• 用代码块展示了 hexo new、hexo server

你可以照着它写：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

---
title: 帝雾刃革征豪万
date: 2026-05-28 13:00:00
tags:
- 小说
- 日记
---

# 帝雾刃革征豪万

这是我的第一段内容。

## 小节标题

- 这里是第一点
- 这里是第二点

```bash
echo "写博客很简单"

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

---

## 4. 你现在最常用的写法

你写博客时，最常用的是：

- `#`、`##` 做标题
- `**...**` 做重点
- `[](...)` 做链接
- `-` 或 `1.` 做列表
- `` `...` `` 和 ``` ``` 做代码

---

## 5. 预览方式

写完后，回到项目根目录运行：

```bash
npm run server

然后在浏览器打开本地地址，就能看到你的文章。

如果你愿意，我也可以直接给你写一篇 帝雾刃革征豪万 的样本 Markdown 内容。

模板结构分析

你的博客是一个 Hexo 站点，主题是 loststar。主要结构可以分成三部分：

1. 根目录：站点配置和命令
2. source：文章和页面内容
3. loststar：主题模板和样式

1. 根目录文件

_config.yml

这是 Hexo 的全局配置文件，包含：

• 站点标题 title
• 站点描述 description
• 作者 author
• 站点地址 url
• 文章生成规则 permalink
• 主题名 theme: loststar
• 分页、分类、标签等 Hexo 内部设置

你想修改博客基本信息，就改这里：

• title
• subtitle
• description
• author
• url

package.json

这里是项目依赖和常用命令：

• npm run server：本地预览
• npm run build：生成静态文件
• npm run clean：清理 Hexo 缓存

2. 内容目录

_posts

这里是你的文章内容。你现在已有：

• hello-world.md

Hexo 的文章文件通常是 Markdown，并且包含 Front-matter（头部元数据），例如：

1
2
3
4
5
6

---
title: Hello World
date: 2026-05-28 00:00:00
tags:
- 示例
---

你要写新文章，直接在这里添加新的 .md 文件。

scaffolds

这是 Hexo 新文章默认模板。一般你用 hexo new post "标题" 创建文章时，会按这个模板生成内容。

3. 主题目录：loststar

这是你的博客外观和交互逻辑的核心。

_config.yml

这是主题配置文件，决定很多页面效果和主题功能，比如：

• 头像 avatar
• 背景图 background
• 加载图 loading
• 侧边卡片 card
• 菜单导航 menu
• 页脚 footer
• 代码高亮、数学、搜索、评论等开关

你要改“主题风格”、“导航菜单”、“侧边信息”等，基本都改这里。

layout

这里是页面模板：

• layout.ejs：整体页面骨架，头部、主体、底部都在这里组合
• index.ejs：首页
• post.ejs：文章页
• archives.ejs：归档页
• categories.ejs、tags.ejs：分类和标签页
• comment.ejs：评论区
• menu.ejs、footer.ejs：菜单和页脚部分

如果你想修改页面结构、添加新的模块、改变页面布局，就要改这些 .ejs 文件。

source

这个目录放的是主题的前端资源：

• css/main.css
• js/main.js
• images/
• js/lib/ 中的脚本

修改主题样式、动画、交互效果时，通常在这里改。

4. public 文件夹说明

public 是 Hexo 生成出来的静态站点文件，不是你直接编辑的源文件。

• public 由 npm run build 或 hexo generate 生成
• 你平时改的是 source 和 themes，然后重新生成

5. 你该怎么修改

修改博客基本信息

编辑 _config.yml：

• title
• author
• description
• url

修改主题设置

编辑 _config.yml：

• 修改头像、背景图、菜单、版权、功能开关
• 关闭/开启搜索、评论、数学公式、星空效果等

修改页面样式或布局

编辑 themes/loststar/layout/*.ejs 和 main.css

写新文章

在 _posts 新建 .md 文件：

• title
• date
• tags
• 内容用 Markdown 写

预览网站

在根目录运行：

• npm install（如果你还没安装依赖）
• npm run server
  然后打开浏览器看本地效果

6. 你现在可以先做的两件事

1. 打开 _config.yml，把 avatar、menu、footer 改成你自己的
2. 在 _posts 里新建一篇 Markdown 文章，写一句简单的内容

如果你愿意，我可以继续帮你：

• 讲解 _config.yml 每个配置项的含义
• 给你一个适合这个主题的首页和文章模板
• 帮你搭建“关于我”页面和“归档页”内容

帝雾刃革征豪万

这是我的第一篇正式博客文章，记录一次游戏中的奇妙体验。

开始这一刻

在游戏里，我听到了一个名字：帝雾刃革征豪万。它像谜语一样，在黑夜中闪烁。我决定把这次感受写下来，作为一个故事的开端。

文章结构

这篇文章将包括：

• 游戏场景描述
• 角色感受与思考
• 个人总结

场景描述

当夜幕降临，帝雾席卷而来，整个世界笼罩在淡淡的蓝光下。人物手持长刃，空气里充满了紧张与期待。

• 黑色长刃闪烁寒光
• 烟雾中出现神秘符文
• 脚下土地似乎在颤抖

我的感受

这段旅程让我觉得：

1. 游戏是一种情绪的表达。
2. 每个名字背后都有故事。
3. 用文字记录比单纯的回放更有意义。

写作建议

你也可以这样写博客：

1
2
3
4
5
6
7
8
9
10
11

---
title: 我的游戏体验
date: 2026-05-28 17:00:00
tags:
- 游戏
- 记录
---

# 我的体验标题

这是正文内容，用 Markdown 写段落、标题、列表和代码。

结尾

如果你喜欢这样的写法，可以继续把每一个细节写成一段文字，或者在文章中加入图片和引用。

文章本身也是一次探索，写博客的过程就是把体验变成回忆。

谢谢你阅读《帝雾刃革征豪万》。

Welcome to Hexo! This is your very first post. Check documentation for more info. If you get any problems when using Hexo, you can find the answer in troubleshooting or you can ask me on GitHub.

Quick Start

Create a new post

1

$ hexo new "My New Post"

More info: Writing

Run server

1

$ hexo server

More info: Server

Generate static files

1

$ hexo generate

More info: Generating

Deploy to remote sites

1

$ hexo deploy

More info: Deployment