Obsidian GitHubPage 在线演示
这个网站不是手工编写的 HTML。它来自一个普通 Obsidian Vault,由 npm 上公开的 @obsidian-githubpage/cli@1.1.1 在 GitHub Actions 中校验、构建并部署。
阅读体验 左侧文件树和右侧本页目录都可以独立折叠;右侧目录采用无序号的 Notion 风格链接,并用明显缩进和层级线体现 H2/H3/H4 层级;长数学公式会在自己的容器内横向滚动,不会撑破正文布局。
端到端验证站 如果你正在阅读此页面,说明精确版本 CLI 安装、仓库主题加载、Obsidian Markdown 渲染、文件树导航、Pages artifact 和部署流程已经全部成功。
验证边界 这个静态站验证共享渲染核心、主题、导航和 Pages 发布链路;插件内预览与 Git 协作操作需要把 Starter Vault 复制为独立仓库后,在 Obsidian 桌面端验证。
从这里开始
- 快速开始:安装插件并打开兼容 Vault。
- 发布指南:从仓库配置到 GitHub Pages 上线。
- Git 协作:多人分支、提交、同步与 PR。
- 语法演示:检查 Callout、表格、任务、脚注和数学公式。
当前验收状态
| 验收项 | 本站使用的实现 |
|---|---|
| 编辑源 | 原生 Markdown 文件 |
| 页面结构 | 真实文件夹与文件名 |
| 渲染器 | @obsidian-githubpage/cli@1.1.1 |
| 主题 | Vault 内 .githubpage/theme/ |
| 部署 | GitHub Pages 自定义 Actions |
主题、配置和内容都和 Vault 一起进入 Git。发布排除并不等于保密,敏感信息永远不应提交到公开仓库。[1]
draft: true只阻止页面进入网站产物,不会清除 Git 历史。 ↩︎