我现在写博客，入口是 Obsidian，因为这个是我目前用的比较舒服的笔记软件了
目前这套流程大概是这样：
articles/ Obsidian vault，写日记、文章、配置
blog/ Astro + Mizuki，负责渲染网站
sync-content.js 把 Obsidian 内容同步到 Astro 内容目录
GitHub 保存变更历史
Cloudflare Pages 部署静态站点
我现在的文章源放在 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, 自动化]
分类如果太多，就会变成另一个标签系统。
标签如果太随便，就会变成噪音。
所以我现在给自己定的规则是：
前段时间我就修过一个问题：日记源文件里会带 日记、日常回声、公开整理版 这些系统标签，但读者不需要看到这么多。
现在网站展示时会统一处理：
日记。这件事很小，但很重要。
因为内容源可以复杂，展示给读者的东西要干净。
首页不是仓库索引。
它要做的事情很简单：让第一次来的人知道，这里有什么，值不值得点进去。
所以首页文章卡片现在主要给几类信息：
我以前会有一种冲动，想把很多东西都塞到首页。导航、公告、音乐、随机文章、个人介绍、项目入口，最好都出现一下。
但首页不是杂物桌。
真正有用的是让内容自己站出来。
如果一篇文章标题不清楚、摘要也模糊，那就算首页再好看，读者也不会知道为什么要点进去。
列表页最怕谜语。
只有一个标题，读者不知道文章讲什么。
只有一堆标签，读者又不知道重点是什么。
我现在比较喜欢的结构是：
读者扫一眼就能知道三件事：
归档页则更偏“找东西”。
所以归档页要按年份、日期、标题、标签压缩信息密度。它不需要像首页一样讲故事，它更像目录。
时间线则是另一种逻辑。
它按时间把文章和日记放在一起。日记是状态，文章是沉淀。有些文章是被日记引用出来的，所以在筛选“日记”时，我也希望相关的文章能留下来。
这个细节有点绕，但符合我的使用方式：日记不是孤立的一天，它经常会连到一篇更完整的文章。
文章页最重要的是别打扰阅读。
我现在保留这些信息：
这些信息都应该帮助读者建立上下文，而不是抢正文的注意力。
比如修改历史以前单独占一行，看起来就有点多。后来我把它收进文章元信息里，和发布日期、分类、标签放在一起。
这不是为了少几个像素。
而是文章页应该稳定。读者点进来以后，视线应该自然落到标题和正文，而不是被一堆维护信息拦住。
还有一个细节是 description。
它不只是 SEO 字段。
它也是列表页摘要、分享预览、RSS 描述的一部分。写好 description，等于帮读者提前判断一次。
我最不想要的流程是：
写一篇文章。
手动复制到网站目录。
手动改图片路径。
手动构建。
手动提交。
手动部署。
然后某一步忘了，网站炸了。
现在的流程已经收敛成一个按钮或一条命令：
.\scripts\deploy-blog-from-obsidian.ps1 -SkipInstall -CommitChanges -PushChanges
它会做这些事：
articles/ 里的文章、图片、站点配置。Obsidian 里还有一个本地插件入口：一键提交并部署博客。
这样我写完之后，不需要重新想一遍部署流程。
发布流程越固定，我越容易把注意力放回内容。
这才是重点。
有。
第一，新文章创建已经收口了。
现在可以在 blog/ 里运行 pnpm new-post <slug> [标题]，它会直接创建 articles/posts/<slug>/<slug>.md。blog/src/content/posts/ 只保留为同步产物，不再当写作入口。
第二，标签还要继续收敛。
有些旧文章的标签来自不同阶段，风格不完全统一。这个不急，但以后要慢慢清。
第三，首页的内容价值还可以更明确。
现在它能展示文章，但还可以更清楚地区分“技术折腾”“资源整理”“日记/随笔”。不是做大而全的门户，而是让读者更快知道这里有什么。
第四，部署后应该少改代码，多维护内容。
当然，这句话我写出来就知道很难。因为我看到一个按钮不顺眼还是会想改。
但至少方向是对的。
博客系统应该逐渐退到后面。
前面留下来的，应该是文章、日记、项目和我真正想记录的东西。
此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。 原文来自 — 版权归原作者所有。