A plugin for Sublime Text that formats (indents) HTML source code. It makes code easier for humans to read.
A plugin for Sublime Text , that formats (indents) HTML source code. It makes code easier for humans to read.
Due to a conflict with other keymaps in Sublime Text, I am reverting the keymap back to the original setting:
Command-Option-Shift-F
Control-Alt-Shift-F
Control-Alt-Shift-F
(To change this, see instructions later in this README…)
Currently, this script chokes a bit with inline comments.
For example:
So, a workaround is to keep comments on their own lines:
(TODO: Fix this!)
This script uses
\tcharacters to create indentation levels and spacing—ST appears to honor whether the user prefers spaces or tabs in ST settings and adjusts accordingly.Use
tag_pos_inlinesetting to define tags that might appear on one line.Windows Users: You must restart Sublime Text to complete the installation.
Installation (Package Control)
If you have Package Control installed in Sublime Text:
- Open the Command Palette (Tools > Command Palette…)
- Search for and choose "Package Control: Install Package" (give it a few seconds to return a list of available packages)
- Search for "HTMLBeautify" and install.
- Windows users will need to restart Sublime Text to finish the installation.
Installation (Manual)
- Download the zip, re-name resulting folder to:
HTMLBeautify, then put the folder into your Sublime Text Packages folder.Usage
- Open a file containing HTML.
- Select HTML code you want to beautify. (If no selection is made the plugin will run on the whole file.)
- Use the appropriate key command to run HTMLBeautify—or use HTMLBeautify from the Edit menu.
- You can test the script with
HTMLBeautifyTest.html: an HTML file with wacky indenting so you to see how this script works.Settings
You can configure which tags should be processed with this script:
ignored_tag_opening: What are the opening tags that tell the script to ignore HTMLBeautify formatting? ignored_tag_closing: What are the closing tags that tell the script to resume HTMLBeautify formatting? tag_indent: If one of these opening tags is encountered, the contents (next line) will be indented by one level. tag_unindent: If one of these closing tags is encountered, the next line will be un-indented one level. tag_unindent_line: If one of these closing tags is encountered, this line is un-indented one level. tag_pos_inline: These are special “one line” tags that open and close on the same line, so indenting should be ignored. remove_extraline: Set true to remove empty line.Changing the Key Binding
You can create your own custom keymap (key command/macro) in your keymap file:
Packages/User/Default[OS].sublime-keymap{ "keys": ["super+alt+shift+f"], // create your own key command combination here! "command": "html_beautify", // command that executes html_beautify "context": [{ // these options ensure that the command is executed in the right files/context "key": "selector", "operator": "equal", "operand": "text.html,text.html.twig,text.twig,source.html,source.html.twig,source.twig" }] }For more details: Sublime Text Unofficial Documentation: Key Bindings
Disclaimer
This script has been tested for basic HTML coding situations, but your mileage may vary—use with caution if using this in a production environment. (Please report bugs or contribute corrections to the script!) Although the script does not remove or modify code directly (it only attempts to adjust indentation levels), be sure to test this script throughly to make sure it works as expected! The author is not responsible for any bugs that might be introduced to your HTML. :)