文档属性速查表

---

字段	必填	作用一句话	如果不填/留空会怎样	常用场景示例
title	✅	文章页 <title>、H1、RSS、SEO 标题	编译报错	任何文章
date	✅	发布时间，用于排序、RSS、timeline	用文件 git 创建时间	任何文章
updated	❌	手动指定“最后修改”时间	自动取 git 最新提交时间	旧文大更新想提示读者
category	❌	顶级分类，方便归档页分组	显示为“未分类”	技术 / 随笔 / 周刊
tags	❌	多标签，方便搜索/聚合	无标签页入口	['React', '性能优化']
status	❌	draft 则不发布、published 才上线	默认 published	写完先存草稿
hidden	❌	true 时连直链都 404，完全隐身	默认 false	提示页、备忘页
description	❌	SEO 摘要 & 列表副标题	自动截取正文前 200 字	自定义更吸引人的摘要
cover	❌	封面图，用于列表、OG 卡片	用主题默认图	放图床 16:9 横幅
sidebar	❌	右侧目录栏是否出现	默认 true	短文可 false 省空间
outline	❌	目录深度 [h2,h3] 范围	默认 [2,3]	深度文改 [2,4]
comment	❌	当前页是否加载评论区	默认 true	转载/公告关评论
search	❌	允许被全文搜索索引	默认 true	隐私页 false
sticky	❌	数字越大列表越靠前	不置顶	系列开篇/活动文
hot	❌	true 强制进“热门文章”池	需手动开	精品曝光
recommend	❌	true 加入“推荐阅读”随机池	需手动开	增加长尾流量
series	❌	把多篇串成系列，左右翻页	无系列导航	周刊、教程连载
badge	❌	文章角标文字+颜色	无角标	新文章 text: 新
readingTime	❌	顶部是否显示“阅读时长”	默认 true	水文可关
wordCount	❌	是否显示“字数统计”	默认 true	短文可关
author	❌	多作者博客时指定作者	用默认作者	客座投稿
reproduced	❌	true 时显示“转载”标识	默认 false	转载文
source	❌	转载来源名称	需 reproduced: true	知乎/公众号
sourceLink	❌	原文链接	需 reproduced: true	可点回源站