ai-notes-site
2026.10.06
·运行中
静态站点Node.js自建
想解决的问题
我想做一个自己的学习记录站,但不想每次加内容都去改代码。
方案
内容(Markdown)和生成逻辑(Node 脚本)分开:
content/ ← 我只管往这里丢 .md 文件
notes/文字稿
ideas/ 联想
tools/ 工具
projects/ 项目
scripts/ ← 生成逻辑,不动
dist/ ← 生成出来的纯静态站
跑一条 node build.js 就重新生成整个站。
几个当时纠结的点
为什么不用现成的静态站生成器? 试过,但 Markdown 解析和模板都要按我的需求改,改的成本比自己写一套大。
为什么强调静态渲染? 因为文字稿是核心内容,搜索引擎必须能抓到正文。如果用客户端渲染,搜索不到,违背了做这个站的初衷。
搜索怎么做的? 构建时把所有内容的标题、摘要、标签、正文片段抽成一个索引写进 HTML,浏览器里做过滤。好处是没有后端、离线也能搜。缺点是内容量很大时索引会变重,到时候再说。
还没做的
- 全文搜索还没覆盖正文长片段,只搜了摘要
- 移动端的标签筛选条可以再紧凑些
- 想加个"最近 30 天更新"的侧栏