关于任务列表

重要提示

任务列表块已被淘汰。您可以在GitHub 博客上了解更多信息。

您可以使用子议题来替代任务列表块。子议题在每个议题中提供专门的章节，使得在不依赖 Markdown 的情况下更容易跟踪相关工作。有关子议题的更多信息，请参阅添加子议题。

任务列表是一组任务，每个任务在单独的行上显示，并配有可点击的复选框。您可以选中或取消选中复选框，以将任务标记为已完成或未完成。

您可以使用 Markdown 在 GitHub 的任何评论中创建任务列表。如果在任务列表中引用了议题、拉取请求或讨论，该引用将展开显示标题和状态。

关于问题任务列表

如果您在议题正文中添加任务列表，该列表将具有额外功能。

为了帮助您跟踪团队在议题上的工作，议题任务列表的进度会出现在 GitHub 的多个位置，例如仓库的议题列表。
如果任务引用了另一个议题且有人关闭了该议题，任务的复选框将自动标记为已完成。
如果任务需要进一步跟踪或讨论，您可以将任务悬停并点击，将其转换为议题位于任务右上角。若要在创建议题前添加更多细节，您可以使用键盘快捷键打开新议题表单。有关更多信息，请参阅键盘快捷键。
任务列表中引用的任何议题都会标明它们正在被引用的议题所跟踪。

Screenshot of an issue showing a tasklist under the header "Features." Three list items link to other issues.

要创建任务列表，请在列表项前加上连字符和空格，然后跟随 [ ]。要将任务标记为完成，请使用 [x]。

- [x] #739
- [ ] https://github.com/octo-org/octo-repo/issues/740
- [ ] Add delight to the experience when all tasks are complete :tada:

Screenshot showing the rendered version of the markdown. The references to issues are rendered as issue titles.

注意

您无法在已关闭的议题或已关联拉取请求的议题中创建任务列表项。

您可以重新排列任务列表中的项目。首先，点击或将鼠标悬停在任务复选框左侧，直到出现六点网格。然后，拖放该网格将任务移动到新位置。

您可以在同一评论的不同列表之间重新排序任务，但不能在不同评论之间重新排序。

Screenshot of a GitHub issue showing two tasks in a tasklist. A grid of six dots to the left of the second task is outlined in dark orange.

您也可以将任务转换为议题。首先，将鼠标悬停在任务列表中的某个项目上，然后点击.

Screenshot of an issue showing two tasks. The "Convert to issue" icon is highlighted with an orange outline.

任务列表中引用的任何议题都会指明它们是由包含该任务列表的议题进行跟踪的。要从被跟踪的议题跳转到跟踪议题，请点击议题状态旁的 被跟踪自 部分中的跟踪议题编号。

Screenshot of issue 3 showing the issue status of "Open" and the text "Tracked by issue #2", which is outlined in orange.