Problem
Annotation notes are currently rendered as escaped plain text. A URL entered in a note is visible, but it is not styled or clickable, so reviewers must copy and paste it manually.
Annotations also do not expose a stable Copy comment link action. This makes it difficult to reference a specific review comment from another document, issue, or chat.
This is especially useful for cross-document reviews, where one annotation needs to point to the relevant section in another Markdown file.
Proposed behavior
- Make URLs in annotation notes clickable. Either auto-link plain
http:// / https:// strings or support a safe subset of Markdown links.
- Add a Copy comment link action to each annotation.
- Opening a copied link should load the document, scroll to the annotation, highlight it, and open/focus its note.
- The permalink should contain the document URL and a stable annotation identifier, at least for shared annotations.
Security requirements
- Keep the current XSS protection.
- Allow only safe URL schemes such as
http: and https: (and optionally relative links).
- Escape link text and sanitize destinations.
- Use appropriate
rel="noopener noreferrer" behavior for links opened in a new tab.
UX reference
Feishu comments provide both behaviors:
- A URL entered as a plain string is displayed as an underlined, clickable link.
- The comment toolbar provides a button to copy a direct link to that comment.
Acceptance criteria
Environment
Problem
Annotation notes are currently rendered as escaped plain text. A URL entered in a note is visible, but it is not styled or clickable, so reviewers must copy and paste it manually.
Annotations also do not expose a stable Copy comment link action. This makes it difficult to reference a specific review comment from another document, issue, or chat.
This is especially useful for cross-document reviews, where one annotation needs to point to the relevant section in another Markdown file.
Proposed behavior
http:///https://strings or support a safe subset of Markdown links.Security requirements
http:andhttps:(and optionally relative links).rel="noopener noreferrer"behavior for links opened in a new tab.UX reference
Feishu comments provide both behaviors:
Acceptance criteria
Environment