如何写一篇新文章

新文章就是 src/content/posts/ 下的一个 Markdown（或 MDX）文件。文件名会成为 URL 的一部分，例如 my-note.md 对应 /posts/my-note/。

目录

最小模板

在 src/content/posts/ 新建文件，至少写这三个字段：title、description、pubDatetime。

---
title: 文章标题
description: 一两句摘要，会出现在首页卡片和 SEO 描述里。
pubDatetime: 2026-09-13T16:00:00+08:00
tags:
  - 随笔
---

正文从这里开始。

时区按 astro-paper.config.ts 里的 site.timezone（默认 Asia/Shanghai）。pubDatetime 写成 ISO 8601 即可。

常用可选字段

子目录名会进入 URL。如果只是想整理文件、不想影响地址，把文件夹名前加上下划线，例如 _drafts/。

目录怎么出

在正文里写二级标题「目录」，AstroPaper 会在这里生成可折叠目录：

## 目录

构建与预览

pnpm dev      # 本地开发
pnpm build    # 输出到 dist，并生成 Pagefind 搜索索引
pnpm preview  # 预览构建结果

博客计划域名是 blog.jaymie.dev。