Front-matter

418 字
2 分钟
Front-matter

完整属性列表#

属性类型必填说明
titlestring文章标题
publisheddate发布日期
updateddate更新日期,未设置则默认使用发布日期
descriptionstring文章简短描述,显示在首页文章卡片上
imagestring封面图片路径
tagsstring[]文章标签
categorystring文章分类
draftboolean是否为草稿,草稿不会对读者可见
pinnedboolean是否置顶在文章列表顶部
slugstring自定义 URL 路径
langstring文章语言代码(如 zh-CN),仅当与站点默认语言不同时设置
authorstring文章作者
commentboolean是否启用评论,默认 true
licenseNamestring自定义许可证名称
licenseUrlstring自定义许可证链接
sourceLinkstring文章来源链接
passwordstring文章密码,设置后文章将被加密保护
passwordHintstring密码提示,显示在密码输入框上方

封面图片路径#

image 支持以下格式:

  1. 相对路径(相对于文章文件):./cover.jpg
  2. public 目录(以 / 开头):/assets/images/cover.webp
  3. 网络图片(以 http://https:// 开头):https://example.com/cover.jpg
  4. 随机图 APIapi(需在 coverImageConfig.ts 中配置)

自定义 URL (Slug)#

默认使用文件名作为 URL。可以通过 slug 自定义:

---
title: 如何使用 Firefly
slug: how-to-use-firefly
---

文件:src/content/posts/如何使用Firefly.md → URL:/posts/how-to-use-firefly

Slug 建议#

  • 使用英文和连字符:my-awesome-post
  • 保持简洁,具有描述性
  • 避免特殊字符,只使用字母、数字和连字符
  • 发布后不要随意更改,避免影响 SEO 和已有链接

草稿#

在 Front-matter 中设置 draft: true 可将文章标记为草稿。草稿文章不会显示在网站上:

---
title: 草稿示例
draft: true
---

发布时将 draft 改为 false 即可

Front-matter
https://blog.reluxt.com/posts/write/
作者
Reluxt
发布于
2026-05-25
许可协议
CC BY-NC-SA 4.0

评论区

文章目录