Diwanul

第一篇

这是示例文章,用来让构建有内容可跑。写自己的第一篇时删掉它。

这是一篇示例文章,作用只有两个:让 npm run dev 有东西可渲染,以及演示 frontmatter 怎么写。

新建文章

npm run new

会问标题、slug、简介、是否置顶、封面图,然后建好 <slug>.md 与同名的 <slug>.assets/ 目录,并自动用 Typora 打开。图片直接往正文里粘,会自动落进那个目录。

frontmatter

---
title: '标题'                                  # 必填
description: '一句话简介'                       # 必填,首页卡片和悬停浮层显示的就是它
pubDate: '2026-01-01'                         # 必填
heroImage: './my-post.assets/cover.jpg'       # 可选,路径相对于这篇 md 自己,必须以 ./ 开头
pinned: true                                  # 可选,置顶到首页(最多取 3 篇)
updatedDate: '2026-01-05'                     # 可选
---

完整说明见 blog/WRITING.md —— 仓库里那份。