澄屿简介

澄屿是一套基于 Astro 的博客模板。文章保存在 Markdown 文件中，专题和资料书通过 ID 引用正文。构建后得到可以部署的静态页面。

本站是模板演示。文章介绍使用方法，随记和项目展示其他内容类型；Lorem Ipsum 是示例署名，插画也可以替换。

栏目

专题和资料书可以引用同一篇文章。修改正文后，各入口显示同一份内容。文章 ID 决定永久链接，目录位置和标题可以另行调整。

内容文件

• knowledge 保存 Markdown 正文、附件，以及专题和书籍的 YAML 文件。
• site.config.ts 设置站名、作者、首页文案和部署地址。
• src 保存 Astro 页面、布局、组件和样式。
• dist/public 是构建生成的公开网站，可以重新生成。

日常写作只需维护源文件。构建会校验字段与引用、处理公开范围，再生成页面、附件和搜索索引。

从哪里开始

1. 阅读开始使用澄屿，安装依赖并启动网站。
2. 跟随新建、预览与发布文章创建第一份草稿，在本机查看。
3. 用 Markdown 排版与代码示例检查正文效果，按需整理专题与资料书。
4. 确认公开范围后，构建并部署。

「澄屿入门」专题提供六篇教程的阅读顺序，「澄屿使用手册」按章节收录相同正文。

支持的写法与发布方式

默认支持标准 Markdown、GFM 表格与任务列表、代码围栏和 NOTE 提示。数学、Mermaid、MDX、任意 HTML 和视频嵌入不属于默认能力。

默认静态模式只生成公开网站，不显示登录。可选站主服务供唯一站主登录后阅读已发布的私人内容和预览全文，需要单独配置服务端环境，不提供注册或在线编辑。

准备发布私人内容或部分预览时，先查阅公开范围说明。