Comment Studio for Visual Studio

Download this extension from the Visual Studio Marketplace or get the CI build.

📖 Full documentation — detailed guides for every feature.

Stop wrestling with XML documentation comments. Comment Studio transforms how you write, read, and maintain code documentation in Visual Studio.

✨ Key Features at a Glance

• Rendered Comments — View XML docs as clean, formatted text (no XML noise)
• Markdown Support — Use **bold**, *italic*, `code`, and [links](url) in comments
• Auto-Reflow — Automatically wrap comments to your preferred line length
• Collapse/Expand — Hide comment blocks to focus on code, expand when needed
• Color-coded Anchor Tags — TODO, HACK, BUG, FIXME, NOTE highlighted in distinct colors, plus custom tags
• Better Comments Style — Prefix-based highlighting (!, ?, *, //, -, >) for visual differentiation
• Solution-Wide Code Anchors — Browse all TODOs, HACKs, and notes across your entire solution
• Clickable Issues — #123 links directly to GitHub/GitLab/Azure DevOps issues
• Link Anchors — Navigate to other files, lines, or named anchors with LINK: syntax
• Comment Remover — Bulk remove comments with smart preservation options
• Theme-aware — Works with light and dark Visual Studio themes

Supports: C#, VB.NET, F#, C++, TypeScript, JavaScript, Razor, SQL, and PowerShell

Rendered Comments

See your documentation, not the XML. The Full rendering mode strips away XML noise and displays your docs with proper formatting.

Color-Coded Tags & Better Comments

TODO, HACK, BUG, NOTE, and more are highlighted with distinct colors. Prefix-based highlighting (!, ?, *, //) provides additional visual differentiation.

Code Anchors

Track all your TODOs, HACKs, and notes across your entire solution in one tool window.

Issue Links & Link Anchors

#123 references become clickable links to GitHub, GitLab, Bitbucket, or Azure DevOps. LINK: syntax lets you navigate to files, lines, and named anchors.

Why Comment Studio?

XML documentation comments are essential for IntelliSense and API documentation, but they come with frustrations:

• Hard to read – XML tags clutter the actual documentation content
• Tedious to format – Manual line wrapping and alignment is time-consuming
• Visual noise – Long comment blocks obscure the code you're trying to read
• Easy to miss important notes – TODO and HACK comments blend into the code

Comment Studio solves all of these problems, letting you focus on writing great documentation instead of fighting with formatting.

Getting Started

1. Install the extension from the Visual Studio Marketplace
2. Open any C# or VB.NET file with XML documentation comments
3. Try rendering modes – Use Edit > Comments to switch between Off, Compact, and Full rendering
4. Try reflow – Edit a comment and use Format Document (Ctrl+K, Ctrl+D) to see automatic formatting
5. Try collapsing – Press Ctrl+M, Ctrl+C to collapse all comments and focus on code

Documentation

Feature Requests Addressed

This extension implements functionality requested by users on the Visual Studio Developer Community:

• Option to highlight TODO comments in the editor
• Different types of comments
• Color the TODO comment so it is different
• Enable links in comments that are relative
• Support for showing rendered documentation comments
• Support TODO comments in Visual Studio

How can I help?

If you enjoy using the extension, please give it a ★★★★★ rating on the Visual Studio Marketplace.

Should you encounter bugs or have feature requests, head over to the GitHub repo to open an issue if one doesn't already exist.

Pull requests are also very welcome, as I can't always get around to fixing all bugs myself. This is a personal passion project, so my time is limited.

Another way to help out is to sponsor me on GitHub.