GitBook 发布
若团队文档站已用 GitBook,可把 Obsidian 仓库发布为 GitBook 站点,复用同一套 Markdown 源。
核心要点
配置同步
- GitBook 直接读取 Git 仓库中的 Markdown,把 Obsidian 仓库作为内容源即可
- 用
SUMMARY.md(GitBook 目录)或docs/结构映射侧边栏,对应 Obsidian 的 MOC - 通过 GitBook 的 Git 同步自动拉取提交,无需手动导出
格式适配
- Obsidian 的
[[ ]]双链需转为 GitBook 支持的相对链接或 Markdown 链接 - Callout(
> [!note])GitBook 不原生支持,可用提示组件或预处理转换 - frontmatter 中 GitBook 专用字段(如
slug)按规范补充
注意事项
- 双向编辑会冲突,建议以 Obsidian 为单一写作端,GitBook 仅作展示
- 用 发布入门 对比官方 Publish 的取舍