Front-matter
418 字
2 分钟
Front-matter
完整属性列表
| 属性 | 类型 | 必填 | 说明 |
|---|---|---|---|
title | string | 是 | 文章标题 |
published | date | 是 | 发布日期 |
updated | date | 否 | 更新日期,未设置则默认使用发布日期 |
description | string | 否 | 文章简短描述,显示在首页文章卡片上 |
image | string | 否 | 封面图片路径 |
tags | string[] | 否 | 文章标签 |
category | string | 否 | 文章分类 |
draft | boolean | 否 | 是否为草稿,草稿不会对读者可见 |
pinned | boolean | 否 | 是否置顶在文章列表顶部 |
slug | string | 否 | 自定义 URL 路径 |
lang | string | 否 | 文章语言代码(如 zh-CN),仅当与站点默认语言不同时设置 |
author | string | 否 | 文章作者 |
comment | boolean | 否 | 是否启用评论,默认 true |
licenseName | string | 否 | 自定义许可证名称 |
licenseUrl | string | 否 | 自定义许可证链接 |
sourceLink | string | 否 | 文章来源链接 |
password | string | 否 | 文章密码,设置后文章将被加密保护 |
passwordHint | string | 否 | 密码提示,显示在密码输入框上方 |
封面图片路径
image 支持以下格式:
- 相对路径(相对于文章文件):
./cover.jpg - public 目录(以
/开头):/assets/images/cover.webp - 网络图片(以
http://或https://开头):https://example.com/cover.jpg - 随机图 API:
api(需在coverImageConfig.ts中配置)
自定义 URL (Slug)
默认使用文件名作为 URL。可以通过 slug 自定义:
---title: 如何使用 Fireflyslug: 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 即可
相关文章 智能推荐
1
Markdown PlantUML 图表
Firefly 用于验证 Firefly 中 PlantUML 插件渲染、主题切换与交互能力的示例文章。
2
Markdown 教程
Firefly 一个简明的 Markdown 博客示例。
3
代码块示例
Firefly 使用表达性代码的代码块在 Markdown 中的外观。
4
MDX 格式文章示例
Firefly 这是一个 MDX 格式的示例文章,展示了如何在 Markdown 中使用 JSX。
5
Markdown 扩展功能
Firefly 了解 Firefly 中的 Markdown 功能
随机文章 随机推荐