写完就上线：用 Logseq 搭建公开知识库（Logseq + GitHub Actions + Vercel 实战）

开门见山：这篇文章帮你把 Logseq 里的内容，舒服地变成一个可公开访问的小网站。改造过程不复杂，也尽量不折腾。

这篇文章适合谁

• 想把知识沉淀“摆到台面上”的个人/小团队。
• 希望“写在 Logseq，自动上线”的轻量方案。
• 本文不涉及：评论、全文检索增强、私有访问等高级功能。

开工前准备

• GitHub：1 个 graph 仓库（内容仓库）。
• Vercel：创建1个项目用于绑定 graph 仓库的 gh-pages 分支，并自动部署网页。
• 域名：可选，用于绑定 Vercel 项目。

整体怎么跑的

• 本地写作 → 推送到 GitHub。
• GitHub Actions 自动构建（用自定义的 publish-spa -> 调用自定义的 logseq 过滤+构建 SPA -> 提交到 gh-pages 分支）。
• Vercel 自动部署（从 gh-pages 分支感知变化拉取产物，部署到 Vercel）。

步骤 1：把“要公开的内容”说清楚

• 参考仓库：https://github.com/RTsien/logseq/tree/wiki-0.10.6
• 规则调整：相比原版，由 public:: true 的过滤条件 → 满足 wiki 且不是 wiki:: self。
• 为什么：更好控、少出错，也更符合内容分层。一通百通，后期自己可以尝试个性化过滤条件。
• 参考改动：diff

步骤 2：让构建工具对齐你的改造

• 参考仓库：https://github.com/RTsien/publish-spa/tree/main
• 将内部引用 logseq/logseq 切换到 RTsien/logseq。
• 参考改动：diff
• 小提醒：publish-spa 会把 logseq 和 graph 仓库 clone 到同级目录。
  • 请避免重名：graph 仓库名不要和 logseq 一样。

步骤 3：把自动化部署接起来

在 graph 仓库添加 .github/workflows/publish.yml：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

on: [push]

permissions:
  contents: write
jobs:
  test:
    runs-on: ubuntu-latest
    name: Publish Logseq graph
    steps:
      - uses: actions/checkout@v4
      - uses: rtsien/publish-spa@wiki-0.3.1
      - name: Add a nojekyll file # to make sure asset paths are correctly identified
        run: touch $GITHUB_WORKSPACE/www/.nojekyll
      - name: Deploy
        uses: JamesIves/github-pages-deploy-action@v4
        with:
          folder: www

这段流程做了两件事：

• 用 publish-spa 把站点构建到 www/。
• 再把 www/ 发布到 gh-pages 分支。

步骤 4：交给 Vercel，访问更稳

• 新建 Vercel 项目，直接粘贴 graph 仓库的 GitHub 地址即可快速创建，framework 选择 Other 就行。
• 记得锁定分支到 gh-pages，避免 main 改动引发重复部署。
• 免费量大管饱，有域名的话，绑定项目，Vercel 还会自动配置https证书。

最后

• 从今天起，写在 Logseq 的内容可以更轻松地“走出去”，慢慢变成你的长期资产。