个人知识管理系统的静态站点实践

个人知识管理通常始于零散的文件和笔记。将其迁移到静态站点上，可以获得版本控制、全文搜索和跨设备同步的能力。

目录结构设计

内容按主题分类存储在 src/content/ 下：

1
src/content/
2
├── blog/           # 长文、教程、模块手册
3
│   ├── post-1.md
4
│   └── post-2.mdx
5
├── projects/       # 项目文档和作品说明
6
│   ├── index.mdx
7
│   └── project-name/
8
├── vibe/           # 短记录和生活碎片
9
│   ├── 2026-05-28-morning.md
10
│   └── quick-note.md
11
└── about.mdx       # 关于页面

每个目录对应一个路由，索引文件 index.mdx 用于介绍该栏目。

分类与标签系统

Astro Content Collection 支持通过 schema 定义字段类型：

1
export const blog = defineCollection({
2
  type: 'content',
3
  schema: z.object({
4
    tags: z.array(z.string()),
5
    series: z.string().optional(),
6
    draft: z.boolean().default(false),
7
  }),
8
});

标签用于文章归档，系列（series）适合关联主题相关的多篇内容。

全文搜索配置

Pagefind 为所有 Markdown 文件生成索引。在 site.toml 中调整搜索行为：

1
[config.search]
2
enabled = true
3
shortcut = "mod+k"
4
placeholder = "Search notes..."
5
maxResults = 6

搜索结果会高亮关键词，并显示每篇文章的标题、摘要和发布日期。

RSS Feed 与内容分发

Astro 提供 RSS 插件自动为博客生成 feed：

1
export default {
2
  integrations: [
3
    rss({
4
      site: 'https://yourdomain.com/',
5
      output: '/rss.xml',
6
    }),
7
  ],
8
};

这允许读者通过 Feedly、Inoreader 等工具订阅你的内容更新。

Sitemap 自动生成

站点地图帮助搜索引擎发现新页面：

1
export default {
2
  integrations: [
3
    sitemap({
4
      filter(page) {
5
        return !page.includes('/draft');
6
      },
7
    }),
8
  ],
9
};