Skip to content

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 的取舍

相关阅读 ​