Stop reading raw XML. Start seeing your documentation.
Render Doc Comments is a high-performance Visual Studio extension that transforms cluttered documentation comment tags into clean, beautifully formatted documentation blocks—instantly. It's designed to stay out of your way when you're coding and provide total clarity when you're reviewing.
Writing documentation shouldn't feel like looking at a configuration file. Our extension offers powerful, flexible ways to manage your workflow:
- Caret-Based Mode (Default): The second you click into the comment, it reverts to raw XML for zero-friction editing. Move your cursor away to see the polished preview.
- Margin Glyph Mode (Premium): Prefer manual control? Use the dedicated Margin Glyph toggle to switch between raw XML and rendered docs regardless of where your cursor is.
- Comment Tag Rendering: Drop a
TODO,FIXME, orWARNinto any comment and it's instantly rendered as a colour-coded badge inline — no more scanning walls of text for the flags that actually matter. - Comment Tags Explorer: A dedicated tool window rolls up every tagged comment across your solution into one searchable view, grouped by tag or by file, so you can jump straight to any TODO without hunting through the codebase.
- Scroll Bar Tag Markers (Premium): Coloured indicator tick marks appear on the editor scroll bar for comment tags, allowing instant visual navigation with a single click.
- Comment Boxes & Section Banners (Premium): Wrap plain
//comments into styled boxes or collapse section divider comments and#regionblocks into clean, modern visual header bars.
Before
After
Access all your settings and Premium features via: Extensions > Render Doc Options
Access Comment Tags Explorer via: View > Other Windows > Comment Tags Explorer
From here, you can toggle between Caret-based hiding and Margin Glyph control, customize your typography, configure scrollbar markers, adjust your accent bar styles, and configure comment boxes and header banners.
| Feature | Free Edition | Premium License |
|---|---|---|
| Multi-Language Support (C#, F#, C++, VB.NET) | ✅ | ✅ |
| High-Fidelity Rendering | ✅ | ✅ |
Interactive cref Links |
✅ | ✅ |
| Per-File Toggle (Toolbar Button & Context Menu) | ✅ | ✅ |
| Viewport Pre-Rendering (Large File Performance) | ✅ | ✅ |
| Caret-Based Auto-Hide | ✅ (Always On) | 🔘 Selectable |
| Margin Glyph Toggle | ❌ | 🔘 Selectable |
| Theme Synchronization | Manual (Reopen File) | ⚡ Instant Auto-Sync |
| Rendered Comment Fixed Width | Only Auto-width | 🔘 Selectable |
| Rendered Comment Use Custom Fixed Width | ❌ | ⚙️ Customizable |
| Typography (Doc Comments) | Segoe UI (Fixed) | 🎨 Fully Custom |
| Accent Bars | Left Side Only | 🔥 Multi-side Layout |
| Color Profiles & Gradient Presets | Default | 🌈 Full Customization & Presets |
| Comment Tag Render | ✅ | ✅ |
| Comment Tag Render Style (Pill/Card) | 🔘 Selectable | 🔘 Selectable |
| Comment Tag Typography | Editor Font (Fixed) | 🎨 Fully Custom |
| Tag Comments Render Color | Default | 🌈 Full Customization |
| Per-Tag Visibility Toggle | All Tags Enabled | 🔘 Selectable |
| Scroll Bar Tag Markers | ❌ | ✅ Interactive Markers |
| Comment Tags Explorer | Tag Explorer | Tag + File Explorer |
Comment Boxes (plain // comments) |
❌ | ✅ Premium |
| Banner Comments (section header bars) | ❌ | ✅ Premium |
#region Directive Banners |
❌ | ✅ Premium |
| Box & Banner Styling (Fonts, Rules, Heights, Colors) | ❌ | ⚙️ Fully Customizable |
Built to feel like a native part of the IDE, the extension uses a signature Purple Gradient accent to define your documentation boundaries.
- Theme Agnostic: Whether you use Dark, Light, or a custom community theme, the background matches perfectly.
- System Native: Uses Windows default font styles (Free) or your own choice (Premium) to ensure your IDE stays lightweight and crisp.
- Pre-requisite: Download and install .net Framework v4.7.2 or above.
- Install: Download from the Marketplace and restart Visual Studio (VS2022, VS2026).
- Open: Any C#, F#, C++, or VB.NET file with standard documentation comments.
- Enjoy: Your documentation will render automatically.
This project is proudly licensed under GNU GPL v3. We believe in open-source transparency. The core rendering engine is free for everyone, while Premium features support the continued development of the tool.
Elevate your code readability today — across every language in your solution.