Highlight whitespaces in code. Separate colors for tabs and spaces.
Go to file
Will Bradley f030fe86ee Add /Packages
The repository seemingly needs to be cloned into the Packages folder in order to work.
2015-02-17 13:02:06 -07:00
Default (Linux).sublime-keymap add keymaps 2012-10-05 00:26:23 +03:00
Default (OSX).sublime-keymap add keymaps 2012-10-05 00:26:23 +03:00
Default (Windows).sublime-keymap add keymaps 2012-10-05 00:26:23 +03:00
Default.sublime-commands modify sublime-commands 2012-10-05 00:31:23 +03:00
MIT-LICENSE First commit. 2011-10-17 23:15:03 +02:00
Main.sublime-menu Add package settings menu and option to Edit menu (close #3) 2013-05-03 14:38:31 +03:00
README.md Add /Packages 2015-02-17 13:02:06 -07:00
highlight_whitespaces.py Restored option to allow highlight on single space, but set as false by default 2013-10-21 19:14:30 +05:30
highlight_whitespaces.sublime-settings Update commented file settings in .py head 2013-08-27 12:03:12 +03:00



This is a plugin for Sublime Text 2 and 3.

Highlight whitespaces in documents

This plugin will highlight each tab or more-than-one space in the document.


Go to your Packages subdirectory under ST2's data directory:

  • Windows: %APPDATA%\Sublime Text 2
  • OS X: ~/Library/Application Support/Sublime Text 2/Packages
  • Linux: ~/.config/sublime-text-2/Packages
  • Portable Installation: Sublime Text 2/Data

Then clone this repository:

git clone git://github.com/disq/HighlightWhitespaces.git

That's it!

Note for ST3 users: For Sublime Text 3, replace "2" with "3" in path names. (%APPDATA%\Sublime Text 3 and so on)


Several options are available to customize the plugin look 'n feel. The config keys goes into config files accessible throught the "Preferences" menu.

Toggle highlight shortcut

The default toggle highlight shortcut is ctrl+alt+w (cmd+alt+w for OS X)

Disable highlighting when Sublime Text starts up

Change highlight_whitespaces_enabled from the default of true to false.

Change the highlighting color

One may also change the highlighting color, providing a scope name such as "invalid", "comment"... in "File Settings - User":

	"highlight_whitespaces_space_highlight_scope_name": "invalid",
	"highlight_whitespaces_tab_highlight_scope_name": "invalid"

Actually, "invalid" is the default value. If you'd like to use a custom color, it should be defined as a color scope in your theme file. Feel free to ask me how to do it.

Disabling highlighting for large files

Highlighting may be disabled for large files. The default threshold is around 1M chars. This is configurable (in "File Settings - User"); unit is number of chars:

{ "highlight_whitespaces_file_max_size": 1000}


This is a modified version of the TrailingSpaces plugin by Jean-Denis Vauguet and Oktay Acikalin

TrailingSpaces is at https://github.com/SublimeText/TrailingSpaces/