Last active
March 8, 2026 00:11
-
-
Save DominoPivot/bb68d475200e5b5ce85d0968a42230be to your computer and use it in GitHub Desktop.
Visual Studio Code color customizations for subdued documentation comments in an otherwise high contrast dark theme.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| { | |
| // Applies a flat white on black theme with cyan borders and orange focus indicators. | |
| "workbench.colorTheme": "Default High Contrast", | |
| // Applies an orange border to the gutter instead of the current line. | |
| "editor.renderLineHighlight": "gutter", | |
| // Alternatively, you could adjust the border's alpha component. | |
| // "workbench.colorCustomizations": { "editor.lineHighlightBorder": "#F3851880" }, | |
| // Overwrites some of the Default High Contrast colors to: | |
| // - make documentation comments and tags within it (such as JavaDoc and JSDoc) a dull shade of green | |
| // - give a brighter shade of green to inline comments and links within documentation comments | |
| // - make type names and numeric constants slightly less green | |
| "editor.tokenColorCustomizations": { | |
| "textMateRules": [ | |
| { | |
| "scope": [ | |
| "comment.block", | |
| "comment.block.documentation punctuation", | |
| "comment.block.documentation storage.type" | |
| ], | |
| "settings": { | |
| "foreground": "#879B7D" | |
| } | |
| }, | |
| { | |
| "scope": [ | |
| "comment.line", | |
| "comment.block.documentation variable", | |
| "comment.block.documentation entity.name.type" | |
| ], | |
| "settings": { | |
| "foreground": "#8BD465" | |
| } | |
| }, | |
| { | |
| "scope": [ | |
| "constant.numeric", | |
| "constant.other.color.rgb-value", | |
| "constant.other.rgb-value", | |
| "support.constant.color", | |
| "meta.preprocessor.numeric", | |
| "keyword.other.unit" | |
| ], | |
| "settings": { | |
| "foreground": "#C0CBA1" | |
| } | |
| }, | |
| { | |
| "scope": [ | |
| "support.class", | |
| "support.type", | |
| "entity.name.type", | |
| "entity.name.namespace", | |
| "entity.name.scope-resolution", | |
| "entity.name.class", | |
| "storage.type.cs", | |
| "storage.type.generic.cs", | |
| "storage.type.modifier.cs", | |
| "storage.type.variable.cs", | |
| "storage.type.annotation.java", | |
| "storage.type.generic.java", | |
| "storage.type.java", | |
| "storage.type.object.array.java", | |
| "storage.type.primitive.array.java", | |
| "storage.type.primitive.java", | |
| "storage.type.token.java", | |
| "storage.type.groovy", | |
| "storage.type.annotation.groovy", | |
| "storage.type.parameters.groovy", | |
| "storage.type.generic.groovy", | |
| "storage.type.object.array.groovy", | |
| "storage.type.primitive.array.groovy", | |
| "storage.type.primitive.groovy", | |
| "meta.type.cast.expr", | |
| "meta.type.new.expr", | |
| "support.constant.math", | |
| "support.constant.dom", | |
| "support.constant.json", | |
| "entity.other.inherited-class", | |
| "punctuation.separator.namespace.ruby" | |
| ], | |
| "settings": { | |
| "foreground": "#45C9B9" | |
| } | |
| } | |
| ] | |
| } | |
| } |
Author
Author
Here is an example of what it can look like.
Note how bracket pair colorization is applied on top of the color customizations in your settings, and I do not think there's a way to specifically disable it inside documentation comments. If you don't like having a bunch of bright #FFD700 yellow brackets around type names, you could make the first bracket color #D4D4D4 and shift the defaults by one position.
{
"workbench.colorCustomizations": {
"editorBracketHighlight.foreground1": "#D4D4D4",
"editorBracketHighlight.foreground2": "#FFD700",
"editorBracketHighlight.foreground3": "#DA70D6",
"editorBracketHighlight.foreground4": "#87CEFA"
}
}
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
(Updated the file extension to
.jsoncso Github highlights JSON with comments properly.)