如何写一篇新文章

这篇短文介绍日常写作与发布流程，方便你快速上手。

新建文章

在博客根目录执行：

npx hexo new "文章标题"

也可以带上分类：

npx hexo new post "文章标题" --path "自定义路径"

命令会在 source/_posts/ 下生成 Markdown 文件。开启 post_asset_folder: true 后，同名的资源目录会自动创建，图片放进该目录并使用相对路径引用即可：

![示例](./cover.jpg)

Front-matter 常用字段

---
title: 标题
date: 2026-11-02 20:00:00
tags: [标签一, 标签二]
categories: [分类]
cover: /img/default_cover.jpg   # 文章封面
top_img: /img/default_cover.jpg # 顶部大图
---

本地预览

npx hexo server

浏览器打开 http://localhost:4000 即可预览，修改 Markdown 后刷新页面就能看到变化（部分配置改动需要重启）。

生成与部署

npx hexo clean && npx hexo generate

生成的静态文件位于 public/ 目录，把它上传到任意静态托管服务即可。具体部署方式见项目根目录的 DEPLOY.md。