Docs feedback: Clarify which markdowns are not support in GitLab comment
From documentation - GitLab Flavored Markdown :
GitLab automatically renders Markdown content. For example, when you add a comment to an issue, you type the text in the Markdown language. When you save the issue, the text is rendered with a set of styles. These styles are described on this page.
Table of contents
A table of contents is an unordered list that links to subheadings in the document. To add a table of contents to a Markdown file, wiki page, issue request, or merge request description, add the[[_TOC_]]
tag on its own line.
The above two sections from the documentation implies that markdown for Table of Contents (ToC) should work in issue comments, however, this seems to be not be the case according to !24196 (merged) and in this issue: #239303 (closed)
Proposal
Explicitly mention that markdown for ToC does not work in issue comments and notes to ensure our documentation is the Single Source of Truth.