新文章就是 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
author: 小马哥
featured: false
draft: false
tags:
- 随笔
---
正文从这里开始。
常用字段
title:标题description:摘要pubDatetime:发布时间(建议带时区,如+08:00)tags:标签列表featured:是否出现在首页精选draft:true时构建不会发布
子目录
可以把系列文章放进子目录,例如 src/content/posts/weknora/00-quickstart-handbook.md,对应 URL /posts/weknora/00-quickstart-handbook/。
本地预览
pnpm install
pnpm dev
pnpm build
pnpm preview