Skip to content

Instantly share code, notes, and snippets.

@DominoPivot
Last active March 8, 2026 00:11
Show Gist options
  • Select an option

  • Save DominoPivot/bb68d475200e5b5ce85d0968a42230be to your computer and use it in GitHub Desktop.

Select an option

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.
{
// 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"
}
}
]
}
}
@DominoPivot
Copy link
Author

(Updated the file extension to .jsonc so Github highlights JSON with comments properly.)

@DominoPivot
Copy link
Author

Here is an example of what it can look like.

sample

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