Write your first article

Write your first article

Install the project once, create an article, then write its Markdown body. Preview locally and publish the generated files.

Use Node.js 22.12 or later. The build generates dist/. Cloudflare, Vercel, Netlify, EdgeOne Pages and ESA Pages can host these static files. Hashed CSS and JavaScript are cached for one year; HTML revalidates.

npm ci
npm run dev

Open the path printed by the new command. Keep metadata between the two front matter separators; write the article below the second separator. Do not repeat its title as another first-level heading.

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)

Use one category for the article’s subject. Project Pages use post-list with a matching category; the journal shows blog and uncategorized. Tags describe the article and do not determine its list membership.

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