本文目录

文章保存在项目的 Markdown 内容目录中。一次发布包含创建草稿、完成元信息、本地预览和构建验证四个环节。文章链接由固定的 slug 决定，修改标题不会改变链接。

1. 创建 Markdown 文件

在项目根目录运行：

npm run new:post -- data-cleaning-notes "一次数据清洗的记录" --category data --format practice

命令会创建默认不公开的草稿，并填写当天的上海日期。slug 使用小写字母、数字和连字符。命令不会覆盖已有文件。

2. 写好 frontmatter

---
title: 一次数据清洗的记录
description: 记录缺失值、重复记录和异常数据的检查方法，并说明处理策略的适用边界。
slug: data-cleaning-notes
date: "2026-10-04"
category: data
format: practice
tags: ['Python', 'SQL']
featured: false
draft: true
---

标题、摘要、slug 和日期必须填写。日期要加引号，纯日期按上海时间当天零点解释；需要精确时刻时，使用 "2026-10-05T09:00:00+08:00" 这样的带时区格式。

category 是兴趣方向，例如 data；tags 填写正文涉及的具体技术，例如 Python、SQL；format 单独记录文章形式：practice（技术实践）、notes（学习笔记）或 retrospective（项目复盘）。新文章默认使用 practice，标签留空，写作时再填写实际内容。

draft: true 的文章不会进入生产页面、RSS 或站点地图。将 featured 设为 true，可以在首页精选区域展示已发布文章。

3. 撰写正文

用二级标题组织主要章节，三级标题解释细节，正文不要再添加一级标题。代码块注明语言，图片填写描述性的替代文本，引用外部结论时附上出处。

本地运行：

npm run dev

开发环境会显示草稿和预约文章，并给出预览提示。目录由标题生成。需要展示宽表格时，表格区域可以横向滚动，正文不会跟着变宽。

4. 检查与发布

完成内容后，将 draft 改为 false，运行：

npm run verify

检查包含内容模型、固定链接唯一性、类型、发布规则、构建结果、站内链接和分享元信息。通过后再提交内容并部署。

如果日期还未到，文章仍然不会出现在生产构建中。预约发布需要在到期后重新构建；部署钩子和定时任务的设置写在项目 README 中。

5. 更新已有文章

保留 date 和 slug。当正文有实质更新时，添加或修改 updatedAt，例如 updatedAt: "2026-10-06"。它会出现在文章头部与结构化数据中。

更多发布规则见草稿、日期与订阅如何保持一致。