· PKM · 3 min read

欢迎来到 ainaigc

本站展示 Obsidian 笔记如何经过 raw → wiki → output 三层流转，最终变成可发布的网站内容。

这是一个基于 Obsidian + Astro 的个人知识管理（PKM）输出站点，用于演示「笔记如何变成网站」的完整工作流。

核心理念

个人知识管理的核心不是「存得多」，而是让内容可检索、可连接、可输出。

层级用途说明
raw/原始输入剪藏网页、代码片段、未整理素材
wiki/结构化知识实体页、主题页、交叉引用、摘要
output/对外输出文章、HTML 页面、本 Astro 站点

工作流程

1. Ingest（摄入）

将新资料放入 raw/ → LLM 阅读并提取要点 → 写入 wiki/ 摘要页 → 更新索引和相关实体页 → 追加操作日志。

  • 单个源可能触及 10-15 个 wiki 页面
  • 支持单篇精读或批量摄入
  • LLM 充当知识库的维护者，持续建立交叉引用

2. Query（查询）

针对 wiki 提问 → 搜索相关页面 → 综合回答并附引用。

  • 好的回答可以归档回 wiki，成为新页面
  • 输出形式多样：Markdown、对比表、幻灯片、图表

3. Publish（发布）

把 wiki/ 中成熟的内容同步到 Astro 站点的 src/data/post/：

# 开发
cd output/site/astro && npm run dev

# 构建静态站点
npm run build

# 部署到 Cloudflare Pages
wrangler pages deploy dist

为什么用 Astro

  • Markdown 一等公民 — Content Collections 带 schema 校验，frontmatter 结构化
  • 构建时生成静态 HTML — 零 JS 运行时，SEO 友好，加载极快
  • 按需交互 — 可在页面中嵌入 React/Vue 组件，不必整站 SPA
  • 与 Obsidian 几乎无缝 — 标题、列表、代码块、表格、链接直接可用

Obsidian 兼容性

直接可用的语法：标准 Markdown 标题、列表、代码块、表格、YAML frontmatter、[文本](url) 链接。

需要转换的语法：

  • [[双向链接]] → 普通 Markdown 链接
  • > [!note] callout → HTML 或自定义组件
  • ![[image.png]] 嵌入 → ![alt](/path/image.png)

本站工具链

  • Obsidian — 写作和知识管理
  • Claude / LLM — 摄入、查询、wiki 维护
  • Astro — 静态站点生成与发布
  • Cloudflare Pages — 部署托管
  • Pagefind（规划中）— 全文搜索
  • wrangler — CLI 部署

下一步

  1. 完善 wiki 内容的自动同步脚本
  2. 添加 Tailwind 换肤与暗色模式
  3. 对接 Pagefind 实现站内搜索
  4. 探索 RSS 订阅与社交媒体分享优化
Share:
返回文章

Related Posts

View All Posts »