# 评论 (/zh/editor/comments)

<!-- agent-signals: reading_time_min: 1 · est_tokens: 808 · updated: 2026-07-30 -->
Related: [创建和编辑页面](/zh/editor/pages.md), [添加媒体](/zh/editor/media.md), [组织导航](/zh/editor/navigation.md), [配置](/zh/editor/configurations.md), [实时预览](/zh/editor/live-preview.md), [在 Web 编辑器中协作](/zh/editor/collaborate.md)

评论功能可让你和你的团队针对页面中的特定文本留下反馈，而无需修改内容。使用评论在发布之前提出问题、指出问题或讨论更改。

评论仅存在于编辑器内部。它们永远不会包含在已发布的网站中，也不会提交到你的仓库。

所有[角色](/zh/dashboard/roles)——viewers、editors 和 admins——都可以留下评论并回复评论。只有 editors 和 admins 可以解决评论线程。

如果你的分支有一个已打开的 pull request，Mintlify 会将未解决的评论线程摘要添加到该 pull request 的描述中。摘要会列出包含未解决评论的文件、每个线程中的第一条评论，以及跳转到编辑器中相应评论的链接。

当你添加、解决或删除评论时，摘要会自动更新。

<div id="add-a-comment">
  ## 添加评论 [#添加评论]
</div>

1. 选中要评论的文本。
2. 在工具栏中点击 <Icon icon="<svg xmlns=&#x22;http://www.w3.org/2000/svg&#x22; viewBox=&#x22;0 0 24 24&#x22; fill=&#x22;none&#x22;><path d=&#x22;M12 20.5C19.1328 20.5 22 16.4706 22 11.5C22 6.52944 20.1328 2.5 12 2.5C4.13281 2.5 2 6.52944 2 11.5C2 13.5712 2.37034 15.4791 3.37161 17C4.63281 19 3.99253 20.8333 3 21.5C4.61547 21.5 5.70211 20.9858 6.39239 20.4766C6.88252 20.115 7.50688 19.9364 8.0984 20.0815C9.20689 20.3533 10.4991 20.5 12 20.5Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M12.1248 11.5H11.9998M16.125 11.5H16M8.125 11.5H8M12.2498 11.5C12.2498 11.6381 12.1379 11.75 11.9998 11.75C11.8618 11.75 11.7498 11.6381 11.7498 11.5C11.7498 11.3619 11.8618 11.25 11.9998 11.25C12.1379 11.25 12.2498 11.3619 12.2498 11.5ZM16.25 11.5C16.25 11.6381 16.1381 11.75 16 11.75C15.8619 11.75 15.75 11.6381 15.75 11.5C15.75 11.3619 15.8619 11.25 16 11.25C16.1381 11.25 16.25 11.3619 16.25 11.5ZM8.25 11.5C8.25 11.6381 8.13807 11.75 8 11.75C7.86193 11.75 7.75 11.6381 7.75 11.5C7.75 11.3619 7.86193 11.25 8 11.25C8.13807 11.25 8.25 11.3619 8.25 11.5Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" /> **Comment** 图标。
3. 输入评论内容，然后按 <kbd>Enter</kbd> 提交。

<Frame>
  <img src="/_assets/5f3a7d200ec813d19b910c5e46c4b6748fc574909296ae1929b652275925fbc8" alt="网页编辑器中，选中文本上方的悬浮工具栏中的评论按钮。" className="block dark:hidden" />

  <img src="/_assets/ebcb9c5b53a3a0a99e26de42e148addddfa55c4eb0079ce2259788e8fd216d6d" alt="网页编辑器中，选中文本上方的悬浮工具栏中的评论按钮。" className="hidden dark:block" />
</Frame>

<div id="reply-to-a-comment">
  ## 回复评论 [#回复评论]
</div>

要打开评论线程，请点击带高亮的文本或点击评论侧边栏中的线程。输入你的回复，然后按 <kbd>Enter</kbd> 提交。

<Frame>
  <img src="/_assets/25b956430d1e2ce298eebe3307a91a72183cc10258a5bb0447a7a4e4d90daa61" alt="网页编辑器中打开的评论线程和侧边栏中的两个评论线程。" className="block dark:hidden" />

  <img src="/_assets/da3ad40a54c20d295a82a7266f09167d82898b2715d8fa89666ec8133a3888da" alt="网页编辑器中打开的评论线程和侧边栏中的两个评论线程。" className="hidden dark:block" />
</Frame>

<div id="mention-a-teammate">
  ## 提及团队成员 [#提及团队成员]
</div>

在评论或回复中输入 `@` 即可提及团队成员。你只能提及所属组织中的成员。

被提及的团队成员会收到电子邮件通知。

<div id="resolve-a-comment">
  ## 解决评论 [#解决评论]
</div>

当讨论结束时，editors 和 admins 可以解决评论线程。

点击对勾图标可解决线程。 已解决的讨论线程会从评论侧边栏中移除，页面上的高亮也会被清除。

<Frame>
  <img src="/_assets/221e77d35235fc5dad1a89d166176ab302606534b04a17a348b81a1dd8cecab1" alt="网页编辑器中打开的评论线程，用于解决线程的对勾图标高亮显示。" className="block dark:hidden" />

  <img src="/_assets/900bf2fe0b44327744b4f82a275ce55745fbdbf0824caf36e88bd48a660a1084" alt="网页编辑器中打开的评论线程，用于解决线程的对勾图标高亮显示。" className="hidden dark:block" />
</Frame>

<div id="delete-a-comment">
  ## 删除评论 [#删除评论]
</div>

点击评论旁边的垃圾桶图标即可删除该评论。删除线程中的第一条评论会删除整个线程。

你可以删除自己的评论。admins 可以删除任何评论。