GitHub Issues 几乎是世界上最好的笔记本

免费且无限制,支持公开和私人笔记。

全面支持 Markdown,包括几乎所有编程语言的语法高亮。还可以直接拖拽图片或视频到笔记中。

内链功能强大。你可以在 Markdown 列表中粘贴其他 issue 的 URL(任何 GitHub 仓库都行):

你的 issue 会自动拉取其他 issue 的标题,同时那个 issue 也会获得指向你这里的反向链接——完全遵循可见性规则。

搜索功能卓越,支持仓库内搜索、跨仓库搜索,甚至全 GitHub 搜索,再也不怕忘记把内容放在哪了。

API 功能完善,支持导出笔记和创建编辑新笔记。配合 GitHub Actions 的 issue 事件触发,几乎可以自动化任何操作。

唯一缺失的功能?离线同步支持。我在手机上还是主要用苹果备忘录,就因为它能离线工作,之后再与笔记本同步。

受 Hacker News 讨论启发的补充说明

隐私问题不用担心。许多公司向 GitHub 付费来保护源代码和相关资源的安全。GitHub 不会为了"训练模型"之类的事情牺牲这种信任。

任何笔记平台都存在可能泄露笔记的 bug 风险。所以我从不在笔记中存放密码!

不付费、不自建是重要特性。我不想因为配置错误或账单问题丢失笔记!

使用 - [ ] 项目 语法创建清单功能很实用。甚至可以用 - [ ] #ref 引用其他 issue,当那个 issue 关闭时,复选框会自动勾选。

我试过各种本地备份笔记的方法,比如 github-to-sqlite。虽然还没在独立机器上设置定时任务,但真的应该做!

一旦纸质笔记能自动备份到至少两个不同大洲,我就回归纸笔。

GitHub Issues 扩展性强!microsoft/vscode 有 195,376 个 issues,flutter/flutter 有 106,572 个。永远不会用完空间。

将笔记导入 LLM 的格式很有趣。这里有个最近的例子,我用 llm-fragments-github 将一个 50+ 评论、持续 1.5 年的 issue 线程总结成了新评论。

统计数据

我很好奇自己在 GitHub 上创建了多少 issues 和评论。在 Claude 帮助下,发现可以用 GraphQL 查询:

{
  viewer {
    issueComments {
      totalCount
    }
    issues {
      totalCount
    }
  }
}

在 GitHub GraphQL Explorer 工具中运行,得到结果:

{
  "data": {
    "viewer": {
      "issueComments": {
        "totalCount": 39087
      },
      "issues": {
        "totalCount": 9413
      }
    }
  }
}

总共 48,500 个 issues 和评论!