创建博客指南 - ganyvze的博客

404 字

2 分钟

创建博客指南

2026-01-01

博客

文章的前置参数 (Front-matter)#

1
---
2
title: 我的博客文章
3
published: 2026-01-01
4
description: 我的新一篇文章
5
image: ./cover.jpg
6
tags: [Foo, Bar]
7
category: 前端
8
draft: false
9
---

属性	描述
`title`	文章的标题
`published`	文章的发布日期
`description`	文章的简短描述，会显示在首页上
`image`	文章封面图的路径， 1. 以 `http://` 或 `https://` 开头：使用网络图片 2. 以 `/` 开头：使用 `public` 目录中的图片 3. 无上述前缀：相对于该 Markdown 文件的路径
`tags`	文章的标签
`category`	文章的分类
`draft`	是否为草稿，如果设为 `true`，文章将不会被显示

您的文章文件应放置在 src/content/posts/ 目录中。您还可以创建子目录，以便更好地管理您的文章和资源文件。

1
src/content/posts/
2
├── post-1.md
3
└── post-2/
4
    ├── cover.png
5
    └── index.md

所有的文章都保存在项目的 src/content/posts/ 目录下。

在本地找到该目录下的 .md 或 .mdx 文件。
使用 VS Code 或记事本打开。
修改内容：直接编辑正文。
修改元数据：在文件顶部的 --- 之间（Frontmatter），你可以修改：
- title: 标题
- published: 发布日期
- image: 文章封面图
- tags: 标签
保存文件。