atom-beautify 0,4 travis-ci npm

:lipstick: Beautification abstraction package for Atom editor

:lipstick: atom-beautify

Mac OS and
Build Status Build status

Gitter chat Paypal Donations

Throughput Graph

Beautify HTML, CSS, JavaScript, PHP, Python, Ruby, Java, C, C++, C#, Objective-C, CoffeeScript, TypeScript, Coldfusion, SQL, and more in Atom

Before After
Original HTML Beautified HTML
image image

Table of Contents


Atom Package:

apm install atom-beautify

Or Settings/Preferences ➔ Packages ➔ Search for atom-beautify

Important Notice: Analytics

By default Anonymous Analytics is enabled. If you do not wish to have usage data sent to Google Analytics then please disable Anonymous Analytics option before using Atom-Beautify. See Anonymous Analytics section of docs for details. Thank you.

Next Version: Unibeautify

Atom-Beautify is going to be completely rewritten with Unibeautify at its core! See unibeautify branch for work in progress and Issue #1174.

Language Support

See all supported options in the documentation at docs/

Language Grammars File Extensions Supported Beautifiers
Apex Apex .cls, .trigger Uncrustify (Default)
Arduino Arduino .ino, .pde Uncrustify (Default)
C C, opencl .h, .c, .cl Uncrustify (Default), clang-format
Coldfusion html .cfm, .cfml, .cfc Pretty Diff (Default)
Clojure Clojure .clj, .cljs, .edn cljfmt (Default)
CoffeeScript CoffeeScript .coffee Coffee Formatter, coffee-fmt (Default)
C++ C++ .h, .hh, .cc, .cpp, .cxx, .C, .c++, .hpp, .hxx, .h++ Uncrustify (Default), clang-format
Crystal Crystal .cr Crystal (Default)
C# C# .cs Uncrustify (Default)
CSS CSS .css CSScomb, JS Beautify (Default), Pretty Diff, SassConvert
CSV CSV .csv Pretty Diff (Default)
D D .d Uncrustify (Default), dfmt
EJS JavaScript Template, HTML (Angular) Pretty Diff (Default)
Elm Elm .elm elm-format (Default)
ERB HTML (Ruby - ERB), HTML (Rails) .erb HTML Beautifier, Pretty Diff (Default)
Erlang Erlang .erl erl_tidy (Default)
Fortran Fortran - Modern .f90, .F90 Fortran Beautifier (Default)
gherkin Gherkin .feature Gherkin formatter (Default)
Go Go .go gofmt (Default)
Handlebars Handlebars, HTML (Handlebars) .hbs, .handlebars JS Beautify (Default), Pretty Diff
Haskell Haskell .hs stylish-haskell (Default)
HTML HTML .html JS Beautify (Default), Pretty Diff
Jade Jade, Pug .jade, .pug Pug Beautify (Default)
Java Java .java Uncrustify (Default)
JavaScript JavaScript .js JS Beautify (Default), JSCS Fixer, Pretty Diff
JSON JSON .json JS Beautify (Default), Pretty Diff
JSX JSX, JavaScript (JSX), Babel ES6 JavaScript .jsx, .js Pretty Diff (Default)
LaTeX LaTeX .tex Latex Beautify (Default)
LESS LESS .less CSScomb, Pretty Diff (Default)
Lua Lua .lua Lua beautifier (Default)
Markdown GitHub Markdown .markdown, .md Remark, Tidy Markdown (Default)
Marko Marko .marko Marko Beautifier (Default)
Mustache HTML (Mustache) .mustache JS Beautify (Default)
Nunjucks Nunjucks, Nunjucks Templates, HTML (Nunjucks Templates) .njk, .nunjucks Pretty Diff (Default)
Objective-C Objective-C, Objective-C++ .m, .mm, .h Uncrustify (Default), clang-format
OCaml OCaml .ml ocp-indent (Default)
Pawn Pawn Uncrustify (Default)
Perl Perl, Perl 6 .pl Perltidy (Default)
PHP PHP .php, .module, .inc PHP-CS-Fixer (Default), PHPCBF
Puppet Puppet .pp puppet-lint (Default)
Python Python .py autopep8 (Default), yapf
R R .r, .R formatR (Default)
Riot.js Riot.js, HTML (Riot Tag) .tag Pretty Diff (Default)
Ruby Ruby, Ruby on Rails .rb Rubocop (Default), Ruby Beautify
Rust Rust .rs, .rlib rustfmt (Default)
Sass Sass .sass SassConvert (Default)
SCSS SCSS .scss CSScomb, Pretty Diff (Default), SassConvert
Spacebars Spacebars Pretty Diff (Default)
SQL SQL (Rails), SQL .sql sqlformat (Default)
SVG SVG .svg Pretty Diff (Default)
Swig HTML (Swig), SWIG .swig Pretty Diff (Default)
TSS TSS .tss Pretty Diff (Default)
Twig HTML (Twig) .twig Pretty Diff (Default)
TypeScript TypeScript .ts TypeScript Formatter (Default)
UX Markup UX .ux Pretty Diff (Default)
Vala Vala .vala, .vapi Uncrustify (Default)
Visualforce Visualforce .page Pretty Diff (Default)
Vue Vue Component .vue Vue Beautifier (Default)
XML SLD, XML, XHTML, XSD, XSL, JSP, GSP .sld, .xml, .xhtml, .xsd, .xsl, .jsp, .gsp JS Beautify, Pretty Diff (Default)
XTemplate XTemplate .xtemplate Pretty Diff (Default)


Open the Command Palette, type Beautify, and run Beautify Editor.


Selection of Code

It will only beautify selected text if a selection is found -- if not, the whole file will be beautified.

Selection of Code Beautify Selection of Code Beautify Entire File
Select code in Atom editor Only that selection is beautified Without a selection all code is beautified
image image image

Beautify On Save

Beautify On Save can be enabled for each language individually.

For example, for language HTML go into Atom-Beautify's package settings (AtomPreferences ➔ Search for atom-beautify), find HTML, and toggle the Beautify On Save option.


Keyboard Shortcut

You can also type Ctrl-Alt-B as a shortcut or click Packages > Beautify in the menu.

Custom Keyboard Shortcuts

See Keymaps In-Depth for more details.

For example:

  'ctrl-alt-b': 'atom-beautify:beautify-editor'


Edit your .jsbeautifyrc file in any of the following locations:

  • Atom Package Settings
    AtomPreferences ➔ Search for atom-beautify
  • Same directory as current file
  • Project root
    atom-beautify will recursively look up from the current file's directory to find .jsbeautifyrc.
  • Your user's home directory

Note: Comments are supported in .jsbeautifyrc thanks to strip-json-comments.

See examples of both ways inside examples/

See all supported options in the documentation at docs/


See examples/simple-jsbeautifyrc/.jsbeautifyrc.

  "indent_size": 2,
  "indent_char": " ",
  "other": " ",
  "indent_level": 0,
  "indent_with_tabs": false,
  "preserve_newlines": true,
  "max_preserve_newlines": 2,
  "jslint_happy": true,
  "indent_handlebars": true

Nested (Recommended)

See examples/nested-jsbeautifyrc/.jsbeautifyrc.

  "html": {
    "brace_style": "collapse",
    "indent_char": " ",
    "indent_scripts": "normal",
    "indent_size": 6,
    "max_preserve_newlines": 1,
    "preserve_newlines": true,
    "unformatted": ["a", "sub", "sup", "b", "i", "u"],
    "wrap_line_length": 0
  "css": {
    "indent_char": " ",
    "indent_size": 4
  "js": {
    "indent_size": 2,
    "indent_char": " ",
    "indent_level": 0,
    "indent_with_tabs": false,
    "preserve_newlines": true,
    "max_preserve_newlines": 2,
    "jslint_happy": true
  "sql": {
    "indent_size": 4,
    "indent_char": " ",
    "indent_level": 0,
    "indent_with_tabs": false


See docs/


See all contributors on GitHub.

Please update the, add yourself as a contributor to the package.json, and submit a Pull Request on GitHub.


MIT © Glavin Wiechert

Related Repositories



A curated list of delightful Atom packages and resources. ...



A list of keyboard shortcuts for the Atom text editor ...



atom 快捷键 shortcuts ...



some awesome atom-plugins ! ...



:package: Some Useful Atom Packages for Web Developers ! ...

Top Contributors

Glavin001 janbernloehr donaldpipowitch greenkeeperio-bot karolyi prettydiff Sebastian-D ra100 kelvix splodingsocks billrawlinson LaurentTreguier Focus aidistan finalcut markbaas patrick-steele-idem petrui ProgramFan thedadams rrushton fscherwi lhecker emanuelet jhansche sharifzadesina Cortys Bengt fdelbos dvingo


package version
align-yaml ^0.1.8
async ^2.4.1
atom-message-panel ^1.3.0
atom-space-pen-views ^2.2.0
bluebird ^3.5.0
coffee-fmt ^0.12.0
coffee-formatter ^0.1.2
coffee-script ^1.12.6
csscomb ^4.2.0
diff ^3.2.0
editorconfig ^0.13.2
eslint ^4.0.0
event-kit ^2.3.0
expand-home-dir 0.0.3
extend ^3.0.1
gherkin ^2.12.2
handlebars ^4.0.10
js-beautify ^1.6.14
jscs ^3.0.7
lodash ^4.17.4
loophole ^1.1.0
marko-prettyprint ^1.3.6
nginxbeautify ^2.0.1
node-cljfmt 0.5.3
node-dir 0.1.17
node-uuid 1.4.8
open 0.0.5
prettydiff 1.16.37
pug-beautify ^0.1.1
remark 6.0.1
season 6.0.0
semver ^5.3.0
shell-env ^0.3.0
space-pen 5.1.2
strip-json-comments ^2.0.1
temp ^0.8.3
tidy-markdown 2.0.3
typescript 2.4.1
typescript-formatter 5.2.0
underscore-plus ^1.6.6
universal-analytics 0.4.13
which 1.2.14
winston 2.3.1
yaml-front-matter 3.4.0
dev coffeelint 1.16.0


-   v0.29.13 zip tar
-   v0.29.12 zip tar
-   v0.29.11 zip tar
-   v0.29.10 zip tar
-   v0.29.9 zip tar
-   v0.29.8 zip tar
-   v0.29.7 zip tar
-   v0.29.6 zip tar
-   v0.29.5 zip tar
-   v0.29.4 zip tar
-   v0.29.3 zip tar
-   v0.29.2 zip tar
-   v0.29.1 zip tar
-   v0.29.0 zip tar
-   v0.28.28 zip tar
-   v0.28.27 zip tar
-   v0.28.26 zip tar
-   v0.28.25 zip tar
-   v0.28.24 zip tar
-   v0.28.23 zip tar
-   v0.28.22 zip tar
-   v0.28.21 zip tar
-   v0.28.20 zip tar
-   v0.28.19 zip tar
-   v0.28.18 zip tar
-   v0.28.17 zip tar
-   v0.28.16 zip tar
-   v0.28.15 zip tar
-   v0.28.14 zip tar
-   v0.28.13 zip tar