新文章怎么创建#

我现在的文章源放在 articles/posts/

每篇文章一个文件夹，文件夹名就是 slug，里面的 Markdown 文件和文件夹同名

articles/posts/hello-sayori/hello-sayori.md
articles/posts/obsidian-notes-to-blog-pipeline/obsidian-notes-to-blog-pipeline.md

这样做就是为了图片可以直接放在同一个文件夹里

Obsidian 里写文章时，我不需要思考图片到底应该丢到哪个公开目录。文章和素材待在一起，发布时脚本再复制到网站的图片目录

一篇新文章的 frontmatter 大概长这样：

---
title: "文章标题"
published: 2026-06-12
created: 2026-06-12
updated: 2026-06-12
lastEdited: 2026-06-12
updateCount: 0
description: "给列表页和分享卡片看的摘要。"
image: ""
tags: [Obsidian, Astro]
category: 服务器探索
draft: true
---

draft: true 的时候，它就是草稿

写到能见人的程度，再改成 draft: false

这种草稿，就是为了

分类和标签怎么维护#

我现在尽量让分类少一点，标签多一点。

分类像书架，只回答“这篇大概属于哪一类”。

标签像便利贴，回答“这篇里面还提到了什么”。

比如一篇服务器文章可以这样：

category: 服务器探索
tags: [Cloudflare Pages, Astro, Obsidian, 自动化]

分类如果太多，就会变成另一个标签系统。

标签如果太随便，就会变成噪音。

所以我现在给自己定的规则是：

• 分类尽量稳定，不要每篇文章发明一个新分类。
• 标签可以细一点，但要能在未来帮我找东西。
• 日记的系统标签不要直接暴露给读者。
• 真正展示到网站上的标签，要经过清洗。

前段时间我就修过一个问题：日记源文件里会带 日记、日常回声、公开整理版 这些系统标签，但读者不需要看到这么多。

现在网站展示时会统一处理：

• 日记只显示一个 日记。
• 普通文章隐藏日记系统标签。
• 首页、归档、时间线、文章页都走同一个展示规则。

这件事很小，但很重要。

因为内容源可以复杂，展示给读者的东西要干净。

首页如何呈现内容价值#

首页不是仓库索引。

它要做的事情很简单：让第一次来的人知道，这里有什么，值不值得点进去。

所以首页文章卡片现在主要给几类信息：

• 标签：先告诉读者这篇属于什么主题。
• 标题：说清楚文章核心。
• 日期、分类、字数：给一个阅读成本预期。
• 摘要：让人判断是不是自己想看的。

我以前会有一种冲动，想把很多东西都塞到首页。导航、公告、音乐、随机文章、个人介绍、项目入口，最好都出现一下。

但首页不是杂物桌。

真正有用的是让内容自己站出来。

如果一篇文章标题不清楚、摘要也模糊，那就算首页再好看，读者也不会知道为什么要点进去。

列表页如何让读者快速判断要不要点#

列表页最怕谜语。

只有一个标题，读者不知道文章讲什么。

只有一堆标签，读者又不知道重点是什么。

我现在比较喜欢的结构是：

读者扫一眼就能知道三件事：

1. 这篇是什么主题。
2. 大概要读多久。
3. 点进去会不会解决他现在关心的问题。

归档页则更偏“找东西”。

所以归档页要按年份、日期、标题、标签压缩信息密度。它不需要像首页一样讲故事，它更像目录。

时间线则是另一种逻辑。

它按时间把文章和日记放在一起。日记是状态，文章是沉淀。有些文章是被日记引用出来的，所以在筛选“日记”时，我也希望相关的文章能留下来。

这个细节有点绕，但符合我的使用方式：日记不是孤立的一天，它经常会连到一篇更完整的文章。

文章页如何让阅读体验稳定#

文章页最重要的是别打扰阅读。

我现在保留这些信息：

• 标题。
• 发布时间。
• 分类和标签。
• 字数和阅读时间。
• 修改历史。
• 正文。
• 相关文章和上一篇/下一篇。

这些信息都应该帮助读者建立上下文，而不是抢正文的注意力。

比如修改历史以前单独占一行，看起来就有点多。后来我把它收进文章元信息里，和发布日期、分类、标签放在一起。

这不是为了少几个像素。

而是文章页应该稳定。读者点进来以后，视线应该自然落到标题和正文，而不是被一堆维护信息拦住。

还有一个细节是 description。

它不只是 SEO 字段。

它也是列表页摘要、分享预览、RSS 描述的一部分。写好 description，等于帮读者提前判断一次。

部署后如何只专注维护内容#

我最不想要的流程是：

写一篇文章。

手动复制到网站目录。

手动改图片路径。

手动构建。

手动提交。

手动部署。

然后某一步忘了，网站炸了。

现在的流程已经收敛成一个按钮或一条命令：

.\scripts\deploy-blog-from-obsidian.ps1 -SkipInstall -CommitChanges -PushChanges

它会做这些事：

• 同步 articles/ 里的文章、图片、站点配置。
• 构建 Astro 博客。
• 验证构建产物。
• 提交博客相关改动。
• 推送 GitHub。
• 部署到 Cloudflare Pages。

Obsidian 里还有一个本地插件入口：一键提交并部署博客。

这样我写完之后，不需要重新想一遍部署流程。

发布流程越固定，我越容易把注意力放回内容。

这才是重点。

这套流程还有什么要继续修#

有。

第一，新文章创建已经收口了。

现在可以在 blog/ 里运行 pnpm new-post <slug> [标题]，它会直接创建 articles/posts/<slug>/<slug>.md。blog/src/content/posts/ 只保留为同步产物，不再当写作入口。

第二，标签还要继续收敛。

有些旧文章的标签来自不同阶段，风格不完全统一。这个不急，但以后要慢慢清。

第三，首页的内容价值还可以更明确。

现在它能展示文章，但还可以更清楚地区分“技术折腾”“资源整理”“日记/随笔”。不是做大而全的门户，而是让读者更快知道这里有什么。

第四，部署后应该少改代码，多维护内容。

当然，这句话我写出来就知道很难。因为我看到一个按钮不顺眼还是会想改。

但至少方向是对的。

博客系统应该逐渐退到后面。

前面留下来的，应该是文章、日记、项目和我真正想记录的东西。