
Keep code examples, drafts, and notes clean and readable directly inside your
comments! CodeInComments highlights @code-marked comment blocks with the host
language's syntax highlighting, applying subtle opacity and grayscale effects —
it's a subtle difference that makes comments feel like a mini markdown editor.

Supported markers
The extension supports implicit @code markers. The language is inferred from
the host file:
/*@code
const message = "Hello, world!";
console.log(message);
*/
//@code const enabled = true;
The language is inferred from the host file, so markers stay concise and do not
need a language name.
Supported languages
JavaScript, JSX, TypeScript, TSX, Rust, Python, Go, C++, C, C#, and Lua. Support for
additional host languages is coming.
Abbreviations
The $ abbreviation can be enabled with codeInComments.enableAbbreviations:
{
"codeInComments.enableAbbreviations": true
}
When enabled, /*$ ... */, //$ ..., and #$ ... are accepted as aliases for
the corresponding implicit @code forms.
Comments nested inside marked code keep the normal comment color and are not
affected by opacity or grayscale.
Configuration
Controls the opacity applied to marked code. The value is between 0 and 1.
The default is 0.5.
{
"codeInComments.opacity": 0.7
}
Controls the grayscale percentage applied to marked code. The value is between
0 and 100. The default is 25.
{
"codeInComments.grayscale": 40
}
Keeps comments inside highlighted code at their normal color and prevents them
from receiving opacity or grayscale. The default is true. Set it to false
to apply the effects to the entire highlighted range.
Development
Requirements
- VS Code
1.39.0 or newer.
- Node.js and npm.
Install and run
npm install
Open the project in VS Code and press F5 to start an Extension Development
Host. Open a file in any supported language containing a supported marker.
Validate
python3 -m json.tool package.json > /dev/null
for file in syntaxes/*.json; do python3 -m json.tool "$file" > /dev/null; done
node --check extension.js
npm test
npm run build
Project structure
.
├── .gitignore # Git ignore rules
├── .vscodeignore # Extension packaging ignore rules
├── DEVELOPMENT.md # Development guide and checklist
├── README.md # Main documentation
├── extension.js # Entry point
├── marker-ranges.js # Code range detection logic
├── package.json # Project configuration and dependencies
├── public/
│ └── example.webp # Visual example
├── syntaxes/ # TextMate injection grammars
│ ├── comment.message.*.json
└── test/
├── langs/ # Language fixtures for testing
│ └── *.{c,cpp,cs,go,js,jsx,lua,py,rs,ts,tsx}
└── marker-ranges.test.js # Detector unit tests