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

olddogs 2026-06-23 00:11 1

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 不再只是展示内容的地方,而是:



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





⚡ 一句话总结


我只是想给连载小说加一个评论区,结果做了一个“GitHub 里的内容互动系统”。



最新回复 (0)
    没有回复
* 帖子来源V2EX
返回