> ## Documentation Index
> Fetch the complete documentation index at: https://docs.macro.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CommentOnDocumentText

> Start a new inline comment on a passage of a Macro markdown document, on behalf of the user: the passage is highlighted in the document and the comment floats beside it, as when a person selects text and comments. Only use this when explicitly asked to comment on part of a document. Quote the passage exactly as the document reads, within a single paragraph, heading, list item or table cell. If the passage appears more than once the tool refuses and lists each occurrence so you can choose one; if the text is not found, read the document again rather than guessing. Use ReplyToDocumentComment to reply in an existing thread or to comment on the document as a whole.

# CommentOnDocumentText

Start a new inline comment on a passage of a Macro markdown document, on behalf of the user: the passage is highlighted in the document and the comment floats beside it, as when a person selects text and comments. Only use this when explicitly asked to comment on part of a document. Quote the passage exactly as the document reads, within a single paragraph, heading, list item or table cell. If the passage appears more than once the tool refuses and lists each occurrence so you can choose one; if the text is not found, read the document again rather than guessing. Use ReplyToDocumentComment to reply in an existing thread or to comment on the document as a whole.

## Parameters

| Parameter    | Type    | Required | Description                                                                                                                                                                                                               |
| ------------ | ------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `documentId` | string  | Yes      | The id of the markdown document to comment on.                                                                                                                                                                            |
| `text`       | string  | Yes      | The passage to comment on, quoted exactly as the document reads: plain text without markdown syntax such as \*\* or link brackets. Keep it to the words the comment is about; a longer quote is more likely to be unique. |
| `occurrence` | integer | No       | Which appearance of the passage to comment on, counting from 1 in document order. Only needed when the passage appears more than once.                                                                                    |
| `content`    | string  | Yes      | Comment content in macro markdown format. This uses the same syntax as markdown documents.                                                                                                                                |