
如何在这个博客写文章
欢迎来到博客!这是第一篇文章,它身兼两职:给你看排版效果,也当你的发文章说明书。
发文章的完整步骤
- 打开网站的代码文件夹,进入
src/content/blog/目录 - 新建一个文本文件,后缀为
.md,文件名用英文或数字(例如my-first-post.md) - 在文件开头复制下面这段信息并修改,然后空一行,下面写正文即可:
---
title: '文章标题'
description: '一两句话的摘要,会显示在列表卡片上'
pubDate: '2026-10-25'
heroImage: '../../assets/blog-placeholder-3.jpg'
---
正文从这里开始……
- 保存文件,网站会自动收录这篇文章,无需改任何代码
正文可以写什么
这里用的是 Markdown 语法,常用的几个就够日常写作了:
- 粗体用
**文字**,斜体用*文字* - 一级小标题用
## 标题,二级小标题用### 标题 - 列表直接写
- 项目,就像你正在看的这个列表 - 引用别人的话,在行首加
>,会显示成下面这样:
这里是引用样式。适合放摘录、备注或者划重点的话。
- 代码会显示成深色卡片:
console.log('你好,世界');
- 插入图片把图片文件放进
src/assets/,正文里写
小技巧
pubDate决定文章排序,越新越靠前;日期可以写未来的,到那天才“发布”description写得好,列表页的卡片就好看heroImage是封面图,不需要封面可以整行删掉- 不确定效果时保存文件,预览页面会实时刷新,写完自己先读一遍