Threads 插件为你的文档带来协作式内联评论。选中页面上的任意文字，留下评论，开始讨论——所有内容直接存储在 Markdown 源文件中，无需任何数据库。

原作者：@svallory

配置

docmd add threads

plugins: {
  threads: {}
}

配置选项

// 将线程保持在页面底部而非内联
plugins: {
  threads: {
    sidebar: true
  }
}

工作原理

1. 在 docmd dev 中，选中任意文本
2. 出现评论弹窗——写下评论并提交
3. 选中文本被高亮并显示线程标记
4. 线程以 ::: threads 块的形式存储在 Markdown 文件底部
5. 无需数据库——Markdown 文件即真相来源

预览

有讨论的文本会被高亮，线程卡片显示在下方。

已解决的线程以淡化样式显示：

右下角会出现浮动的讨论按钮 💬2，显示未解决线程数量。

存储格式

线程使用 docmd 的容器语法嵌入到 Markdown 中：

# My Documentation Page

Some content with ==highlighted text=={t-a1b2c3d4} that has a thread.

::: threads
  ::: thread t-a1b2c3d4
    ::: comment c-e5f6a7b8 "Alice" "2026-04-09"
      This text needs clarification.
    :::
    ::: comment c-d9e0f1a2 "Bob" "2026-04-09" reply-to c-e5f6a7b8
      Updated it — does this work?

      ::: reactions
        - 👍 Alice
      :::
    :::
  :::
:::

==text=={threadId} 语法将文档正文中的高亮文本链接到特定线程。

功能

Actions API

Threads 插件通过 WebSocket RPC 系统暴露以下 action，可通过 docmd.call() 在浏览器插件中调用：

作者档案

作者信息存储在 <docsRoot>/.threads/authors.json 中：

{
  "alice@example.com": {
    "name": "Alice",
    "avatarUrl": "https://gravatar.com/avatar/..."
  }
}

开发期间，插件会自动检测你的 git 用户名和邮箱用于作者识别。