必需字段#

• title：文章标题（必需）
• description：文章描述（必需）

发布相关#

• published：文章发布日期，格式为 YYYY-MM-DD
• pubDate：文章发布日期（与 published 类似）
• date：文章创建日期
• draft：是否为草稿，true 表示草稿，false 表示正式发布
• permalink: 固定链接

内容分类#

• tags：文章标签数组，用于标记文章主题
• category：文章分类，用于组织文章
• pinned：是否置顶文章，true 表示置顶

作者信息#

• author：文章作者姓名
• licenseName：文章许可证名称，如 “MIT”、“CC BY 4.0” 等
• sourceLink：文章源链接，通常指向 GitHub 仓库或原始来源

图片设置#

• image：文章封面图片

3. 在 frontmatter 下方编写文章内容，可以使用标准的 Markdown 语法。

日期格式#

建议使用 ISO 8601 格式（YYYY-MM-DD）来设置日期：

published: 2025-01-20 date: 2025-01-20 pubDate: 2025-01-20

标签和分类#

• 标签应该具体且相关，避免过于宽泛
• 分类用于高级组织，通常比标签更宽泛
• 示例：

tags: [Vue.js, JavaScript, Frontend, Tutorial] category: Web Development

草稿管理#

使用draft字段来管理文章状态：

• draft: true - 文章不会在生产环境中显示
• draft: false - 文章正常发布

许可证设置#

常见的许可证名称：

• “MIT”
• “Apache-2.0”
• “CC BY 4.0”
• “CC BY-SA 4.0”
• “Unlicensed”

完整示例#

1
title: "Vue.js 3 组合式API完全指南"
2
published: 2025-01-20
3
pinned: false
4
description: "深入了解Vue.js 3的组合式API，包括setup函数、响应式系统和生命周期钩子。"
5
tags: [Vue.js, JavaScript, Frontend, API]
6
category: "Web Development"
7
licenseName: "CC BY 4.0"
8
author: "张三"
9
sourceLink: "https://github.com/zhangsan/vue3-guide"
10
draft: false
11
date: 2025-01-20
12
image: 'https://example.com/vue3-cover.jpg'
13
pubDate: 2025-01-20

预览文章#

保存文件后，可以在浏览器中预览文章。将文章文件名（不包括. md 扩展名）拼接到预览 URL 的末尾即可查看。 例如，如果本地开发服务器运行在http://localhost:4321/，文章文件名为my-first-post.md，则可以通过http://localhost:4321/posts/my-first-post访问文章。

如果文章尚未创建或文件名错误，页面将显示 404 错误。当你预览一个尚未创建的文章时，控制台会显示不同的输出，这有助于进行故障排查。

链接到文章#

要在博客页面或其他页面中链接到你的文章，可以使用标准的 HTML <a> 标签：

<a href="/posts/my-first-post/">我的第一篇文章</a>

确保链接的 href 属性指向正确的文章路径。

添加图片#

如果需要在文章中添加图片，可以将图片文件放在public目录下，然后在文章中通过相对路径引用：

![图片描述](/images/my-image.webp)

创建多篇文章#

你可以在src/content/posts/目录下创建多个 Markdown 文件，每个文件代表一篇文章。例如：

src

content

posts

my-first-post.md

my-second-post.md

my-third-post.md

每篇文章都是一个独立的 Markdown 文件，文件名将被用作文章的 URL 路径。

链接多篇文章#

要在博客页面中链接到多篇文章，可以创建一个文章列表：

1
  <li><a href="/posts/my-first-post/">我的第一篇文章</a></li>
2
  <li><a href="/posts/my-second-post/">我的第二篇文章</a></li>
3
  <li><a href="/posts/my-third-post/">我的第三篇文章</a></li>
4
</ul>

确保每个链接都指向正确的文章路径。

注意事项#

• 文件名将被用作文章的 URL 路径，所以应该具有描述性且不含特殊字符
• frontmatter 中的date字段是可选的，如果不提供，系统会使用文件的创建日期
• 这种方法适合简单的文章，但如果文章包含大量图片，建议使用子文件夹方案