这是一篇示例写作指南,也用于检查代码、引用和表格在本站的呈现效果。
一篇文章,从这里开始
在 src/content/posts/ 下创建一个 .md 文件。文件名会成为文章地址,例如 my-first-note.md 对应 /posts/my-first-note/。
也可以用下面的命令创建草稿,标题、时间与默认配置会自动填好:
npm run new:post -- my-first-note "我的第一篇手记"
命令默认创建未公开的草稿,并拒绝覆盖已有文章。文件名用小写英文、数字与单个连字符,标题可以使用中文。
---
title: '我的第一篇手记'
description: '用一句话介绍这篇文章。'
date: 2026-10-04T10:00:00+08:00
tags: ['技术笔记']
draft: true
cover: cloud
---
写作时保留 draft: true,准备公开时改成 false。草稿不会出现在页面、搜索、标签或 RSS 中。
标题与引用
使用二级标题组织文章,用三级标题描述更细的内容。文章目录会自动收集这些标题。
## 一个值得记录的问题
### 我尝试过的方法
> 记录结论,也记录得出结论的过程。
写一点代码
在代码块开头标明语言,可以获得语法高亮。
每段代码右上角都有「复制代码」按钮。复制完成后会显示提示;剪贴板不可用时会选中代码,方便手动复制。
const thoughts = ['学习', '创造', '日常'];
for (const thought of thoughts) {
console.log(`今天,记下一点${thought}。`);
}
用表格整理信息
| 字段 | 说明 |
|---|---|
title |
文章标题,必填 |
description |
一句话摘要,必填 |
date |
发布日期,推荐写明 +08:00 时区 |
tags |
标签列表 |
draft |
草稿开关,默认 false |
cover |
封面类型:summer、cloud、letter |
发布前,读一遍
- 检查标题和摘要是否准确。
- 确认链接、代码和图片能正常显示。
- 移除
draft: true,重新构建站点。
未来日期的文章会在到达发布日期后的下一次构建中公开。静态站点不会在没有构建的情况下自动更新。