markline

可嵌入的评论系统

支持 Markdown（GFM + 代码高亮）、嵌套回复、点赞。匿名评论，无需注册。 下面是一个真实可用的评论区 —— 直接试试。

0 条评论

排序：

如何接入你的网站

最简单的方式：用 iframe 嵌入 /c/<pageId> 路由。 pageId 用你教程页面的 slug 或 URL（每个页面互相隔离）。

<!-- 1. 在你的教程页面里放一个容器 -->
<div id="comments" data-page-id="your-page-slug" data-title="页面标题"></div>

<!-- 2. 用 iframe 嵌入评论系统（同源最简单；跨源时设置 origin） -->
<iframe
  src="https://markline.example.com/c/your-page-slug"
  style="width:100%;border:0;min-height:400px"
  loading="lazy"
></iframe>

示例：访问 /c/getting-started 查看纯净的嵌入页（无导航，适合 iframe）。

JSON API

想完全自定义前端？直接调用 REST API（CORS 默认放行所有来源，可用SITE_ORIGIN收紧）。

# 通过 JSON API 接入（供自定义 SDK / 前端）
# 列出评论
curl "https://markline.example.com/api/comments?pageId=your-page-slug&sort=newest"

# 发表评论（首次会返回 X-Author-Token 用于后续编辑/点赞）
curl -X POST "https://markline.example.com/api/comments" \
  -H "Content-Type: application/json" \
  -d '{"pageId":"your-page-slug","authorName":"张三","body":"写得很好！"}'

安全