如何在这个博客写文章

欢迎来到博客!这是第一篇文章,它身兼两职:给你看排版效果,也当你的发文章说明书。

发文章的完整步骤

  1. 打开网站的代码文件夹,进入 src/content/blog/ 目录
  2. 新建一个文本文件,后缀为 .md,文件名用英文或数字(例如 my-first-post.md)
  3. 在文件开头复制下面这段信息并修改,然后空一行,下面写正文即可:
---
title: '文章标题'
description: '一两句话的摘要,会显示在列表卡片上'
pubDate: '2026-10-25'
heroImage: '../../assets/blog-placeholder-3.jpg'
---

正文从这里开始……
  1. 保存文件,网站会自动收录这篇文章,无需改任何代码

正文可以写什么

这里用的是 Markdown 语法,常用的几个就够日常写作了:

  • 粗体用 **文字**,斜体用 *文字*
  • 一级小标题用 ## 标题,二级小标题用 ### 标题
  • 列表直接写 - 项目,就像你正在看的这个列表
  • 引用别人的话,在行首加 >,会显示成下面这样:

这里是引用样式。适合放摘录、备注或者划重点的话。

  • 代码会显示成深色卡片:
console.log('你好,世界');
  • 插入图片把图片文件放进 src/assets/,正文里写 ![图片说明](../../assets/图片文件名.jpg)

小技巧

  • pubDate 决定文章排序,越新越靠前;日期可以写未来的,到那天才“发布”
  • description 写得好,列表页的卡片就好看
  • heroImage 是封面图,不需要封面可以整行删掉
  • 不确定效果时保存文件,预览页面会实时刷新,写完自己先读一遍