You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Code blocks in triple slash Doxygen comments are formatted incorrectly #14567
OS and Version: Windows 11 Enterprise version 10.0.26200
VS Code Version: 1.127.0
C/C++ Extension Version: 1.32.2
If using SSH remote, specify OS of remote machine: N/A
Bug Summary and Steps to Reproduce
Bug Summary:
If you place a Markdown code block inside inside a Doxygen comment that uses /// at the start of each line, and that comment contains any Doxygen tag, and you hover over a symbol to view its documentation, then indentation and // at the start of lines inside the code block is stripped.
The same comment switched to use //! formats correctly.
Steps to reproduce:
Write a function with documentation such as the following:
/// Test function////// Example:/// ```/// // This program does the thing./// int main() {/// DoThing();/// return 0;/// }/// ```/// \param x Test parametervoidDoThing(int x);
Expected behavior:
When hovering over the symbol, the documentation should be rendered as
Test function
Example:
// This program does the thingintmain() {
DoThing(1);
return0;
}
Parameters: x - Test parameter
Actual behavior:
The documentation renders like this instead
Test function
Example:
This program does the thing
intmain() {
DoThing(1);
return0;
}
Parameters: x - Test parameter
Removing the \param line or changing the comment style to //! results in the expected rendering.
Configuration and Logs
Occurs in a workspace that only contains a single .cpp file and no c_cpp_properties.json.
Activity
sean-mcmanus commentedon Sep 22, 2026
Joel Spadin (@joelspadin-garmin) Fixed with https://github.com/microsoft/vscode-cpptools/releases/tag/v1.35.2
joelspadin-garmin commentedon Sep 22, 2026
Thanks! I switched to the prerelease and can confirm it is fixed.