用 Markdown 留下技术笔记：静态博客的维护边界

内容是一份可读的文件

本站使用 Astro 静态生成页面，文章由 Markdown 文件管理。标题、摘要、日期、分类和标签放在文件顶部，正文使用普通 Markdown 编写。构建时，Content Collections 校验字段，再生成对应页面。

这样，新增文章不需要复制一份页面组件。布局、导航、页脚与代码样式由公共组件提供，文章作者只需要维护内容。内容仍需人工核实，构建工具不会判断一段项目经历是否真实。

一个最小文章头

---
title: 一篇新的技术笔记
description: 用一句话说明这篇笔记解决的问题。
date: 2026-11-11
category: Web 技术
tags: [Web, Markdown]
status: 技术笔记
---

正文从二级标题开始，一级标题交给文章布局。文件名用于生成 URL，发布后应尽量保持稳定；如果必须改名，需要在服务器侧准备重定向，避免旧链接失效。

搜索留在浏览器里

本站在构建时生成公开文章索引。搜索页面加载这个同源 JSON，然后在浏览器中匹配标题、摘要、标签与正文。查询不会被提交给第三方搜索服务，也没有搜索后端。

索引属于公开内容，因此不能把未准备公开的草稿、隐藏备注或内部资料放进集合。静态网站减少了服务端运行环节，但不替代内容审查。

发布只拿构建结果

源码、依赖和部署说明留在维护目录，Web 根目录只包含 dist 里的构建产物。服务器需要正确处理 404、HTTPS、缓存和安全响应头；本地生成成功不能证明这些配置已经生效。

每次更新应保留上一份可回滚的构建，而不是直接把新文件覆盖到唯一的在线目录。实际服务器路径、证书和现有服务尚需上线前确认。

少一点运行负担

这个版本没有注册、评论、支付或后台。对一个以阅读为主的小站来说，静态页面已经覆盖当前需求。未来若增加互动能力，需要重新审视隐私说明、安全配置与维护成本。

集合接口参考 Astro Content Collections 官方文档。