参考篇:本站能力指南版本更新记录
记录本站能力指南系列的主要内容更新,方便读者了解文档新增了哪些能力说明、使用规范和设计解释。
文章目录8 个章节
这篇文章记录“本站能力指南”系列的主要更新。
如果已经读过前面的文章,可以从这里快速判断最近补了哪些内容。
2026/7/27
补充 Markdown 内容能力说明
新增了代码高亮、Mermaid 图表、KaTeX 数学公式、表格、脚注、引用块、附件下载和音频链接的发布效果说明。
同时补了一篇 Markdown 发布效果演示文章,直接展示同一份 Markdown 在网页端的实际呈现。
补充附件和音视频边界
明确了图片、PDF、Office 文档、ZIP、CSV 和音频文件的写法。
本地附件建议使用相对路径维护关系,方便在 Obsidian 中整理,也方便以后迁移和备份。
本地视频文件不建议直接放进文章目录。视频通常很大,更适合放在 B 站、YouTube、Vimeo 或自己的视频服务里,文章里保留外部视频链接。
补充文章、标签、系列和探索方向的设计解释
补充了为什么公开站不使用文件夹目录作为主要阅读入口。
文章负责完整表达,标签负责横向检索,系列负责连续阅读路线,探索方向负责长期问题脉络。
探索方向和系列都是可选字段。普通文章可以只写标题、摘要、日期和标签;当文章确实属于某个长期问题或阅读路线时,再补充对应字段。
补充公开站、私有 Hub 和个人服务器说明
补充了公开站、私有 Hub、私人应用入口和个人服务器之间的关系。
公开站适合展示整理好的内容,私有 Hub 适合保留草稿预览、内部统计和私人应用入口。
私人应用可以来自自己的小工具、Vibe Coding 生成的应用,或者其它独立服务。这里只负责提供入口,不要求每个人都必须使用。
补充 Obsidian 插件化发布工作流
补充了更省心的发布方式:在 Obsidian 中写作,点击发布,发布时自动检查内容,再同步到个人服务器并更新网站。
Git 可以作为版本历史和备份增强,但不是第一步必须配置的东西。
调整文章口吻和读者表达
统一减少“用户应该怎样”这类表达,改成更接近作者写给读者的口吻。
文档重点放在读者能获得什么、如何理解这套系统、什么时候适合搭建,而不是把内部实现细节提前压给读者。
优化移动端文章阅读
移动端文章页的关联阅读和文章目录改成折叠入口。
桌面端仍然保留左右侧辅助阅读;移动端优先保证正文滑动顺畅,避免目录或关联阅读区域抢走页面滑动手势。