写作

在 Kecare 中，文章存放在 主题目录/.kecare/articles/ 目录下，目前仅支持 Markdown 文件。

创建文章

1. 在 .kecare/articles/ 目录下创建 .md 文件
2. 编写内容

文章结构

文章由 Front Matter 和 正文内容 组成：

---
title: Hello Kecare
date: 2026-01-22 12:00:00
tags:
  - kecare
  - blog
desc: 文章摘要
author: Pamper
menu: test
translate: ['zh-CN', 'en-US', 'ja-JP']
---

# Hello Kecare

正文内容...

Front Matter

每篇文章都可以在开头写一段 Front Matter（YAML 格式），用于提供文章的元信息，例如：标题、日期、标签、描述、作者、封面、置顶、菜单等。

Front Matter 是位于 Markdown 文件开头的 YAML 格式元数据块，以 --- 分隔。Kecare 会解析这些元数据，并将其传递给主题组件使用。

完整示例

以下是 Kecare 中目前支持的所有字段的 Front Matter 示例：

---
title: 写作指南                 # 文章标题
date: 2025-11-19               # 发布日期
tags:                          # 标签列表
  - kecare
  - blog
  - 教程
desc: 这是一篇关于如何使用 Kecare 写作的指南  # 文章摘要
author: 作者名                 # 作者名称
coverSrc: "https://example.com/cover.webp"  # 封面图片
sticky: 1                      # 置顶优先级
menu: kecare-docs              # 所属菜单
translate: ['zh-CN', 'en-US', 'ja-JP']  # 翻译语言，第一个值需为当前语言
---

你无需为每个文章添加所有的 Front Matter 字段，目前仅有 date 字段是必须的，其他的字段如果你不提供值，Kecare 则会使用默认值

运行生成器

写完后运行生成器即可在浏览器中预览。