写好第一篇文章

写好第一篇文章

项目只需安装一次。创建文章,写 Markdown 正文,在本地预览,再发布生成的静态文件。

使用 Node.js 22.12 或更新版本。构建输出 dist/,可部署到 Cloudflare、Vercel、Netlify、腾讯 EdgeOne Pages 与阿里云 ESA Pages。哈希 CSS 与 JavaScript 缓存一年,HTML 保持可重新验证。

npm ci
npm run dev

打开新建命令输出的文件。两道 front matter 分隔线之间保存元数据,正文写在第二道分隔线之后。标题已由文章页显示,正文无需再写同名一级标题。

npm run new -- post "A quiet afternoon"
---
title: A quiet afternoon
date: 2026-10-06
category: blog
---

A story, a picture, and what I noticed.

![By the water](/images/walk.jpg)

用一个 category 表达文章主题。项目页的 post-list 使用对应分类,见闻只展示 blog 与 uncategorized。标签用于描述文章,不决定文章出现在哪个列表。

{
  "type": "post-list",
  "title": "Project notes",
  "category": "edgepress",
  "count": 3
}