做了个好玩的东西,让 GitHub Markdown 有了评论区和统计

可乐 · 2026-06-22 16:20:25 · 12 分钟

CommentSVG

把 GitHub Discussions 变成可以嵌入 Markdown 的动态评论区( SVG ),并顺手做了一个阅读统计系统


💡 我为什么做这个

我在 GitHub 上写一个连载项目(类似数字自传,有看过我《底层重构》的应该知道)。

但写到一半发现一个很现实的问题:

GitHub 的 Markdown 是没有评论区的。

读者只能阅读,不能在内容“里面”留下反馈。

所有讨论都被迫分散到:

  • Issues

  • Discussions

  • 外部平台

但问题是:

内容和讨论是割裂的。


🚨 真正的问题不是“没有评论”

而是:

评论不在内容发生的地方。

对于连载内容来说,这会直接破坏阅读体验。


✨ 我的解决方案

我做了一个很轻的工具:

CommentSVG

核心思路:

把 GitHub Discussions 的评论
👉 渲染成 SVG
👉 直接嵌入 Markdown


📌 项目地址

👉 GitHub 仓库
https://github.com/aihop/CommentSVG

👉 演示项目(连载小说示例)
https://github.com/aihop/Refactoring-the-Self


🖼️ 实际效果

preview

每一章都可以直接拥有“内嵌评论区”。


🧩 系统实现方式( Cloudflare Pages + Workers )

整个系统基于 Cloudflare 架构:


🌐 Cloudflare Pages (展示层)

负责:

  • 项目 demo 页面

  • 文档

  • SVG 嵌入效果展示


⚙️ Cloudflare Workers (核心逻辑)

负责:

  • GitHub Discussions 数据拉取

  • SVG 动态生成

  • Markdown 嵌入接口

  • 缓存与性能优化


📊 顺便做了一个副产品:统计能力

因为所有请求都经过 Worker ,所以可以自然获得:

  • 每一章访问次数(≈阅读量)

  • 评论打开频率(≈互动热度)

  • 哪些章节最活跃

  • 哪些章节没有反馈


🧠 它最终变成了什么

它不只是一个评论系统。

更像是:

一个嵌入在 Markdown 里的“内容反馈 + 阅读分析层”


Markdown 不再只是展示内容的地方,而是:

一个可以被阅读、被讨论、被分析的内容载体

评论

All Comments