← 返回文章2 分钟阅读

在这里写一篇文章,只需要一个 Markdown 文件

一份写给未来自己的使用说明:新建文章、设置标签、保存草稿,然后把文字发布出去。

这是一篇使用示例,介绍博客项目中添加内容的方式。正式写作后,你可以替换或删除这篇文章。

新建文章

在 src/content/blog/ 目录下创建一个 .md 文件,文件名就是文章地址的一部分。建议用简短的英文和连字符,例如 my-first-post.md。

文件开头是文章信息:

---
title: "我的第一篇文章"
description: "用一句话介绍这篇文章。"
date: 2026-10-28
tags: ["生活", "随笔"]
draft: false
featured: false
---

draft: true 的文章不会出现在网站、RSS 或站点地图中。准备好后,再改成 false。

写下正文

文章支持标题、列表、引用、链接和代码块。二级标题会自动生成右侧目录,阅读时间由正文长度估算。

const idea = "今天想做的一件小事";
console.log(idea);

图片可放进 public/images/,然后在文章中使用你部署路径下的图片地址。若部署到子目录,记得包含子目录前缀;也可以将图片放在文章旁并使用 Markdown 相对引用。

本地预览

在终端启动开发服务器:

npm run dev

修改 Markdown 后,预览页面会随之更新。提交前运行:

npm run check
npm test
npm run build

发布更新

提交文章到 GitHub 后,按照所选托管平台的方式重新构建部署即可。这个项目输出的是静态页面,不依赖数据库。

— 感谢阅读 —继续读点什么 →