HTML-BEAUTIFY(1)

💖 HTML-BEAUTIFY 💖

okay so bestie, say hi to html-beautify, aka the manual page for your new favorite glow-up tool. it lives in the User Commands section of the manual, and it's here to do exactly one thing and do it gorgeously ✨

---

🌸 NAME 🌸

html-beautify — beautify, unpack or deobfuscate HTML 💅

like, it takes your crusty little HTML and makes it pretty. that's the whole vibe. no cap.

---

🎀 DESCRIPTION 🎀

html-beautify.js@1.15.4

that's the version, bestie, and she's serving.

✨ CLI Options ✨

these are the knobs you turn at the command line, iykyk:

• -f, --file — the input file(s). and if you wanna be ✨mysterious✨, pass '-' for stdin 👀
• -r, --replace — write the output in-place, replacing the input. girl, it overwrites. be careful, fr fr.
• -o, --outfile — write output to a file instead (default is stdout, so it just vibes into your terminal)
• --config — path to the config file, if you're the organized type 🗂️
• --type [js|css|html] ["js"] — pick your language flavor. default is "js".
• -q, --quiet — suppress logging to stdout. shhh 🤫
• -h, --help — show this help, bestie
• -v, --version — show the version, in case you forgot we're on 1.15.4 💖

---

🦋 Beautifier Options 🦋

now the FUN part. the actual makeover. all the defaults are listed, don't worry, i would never gatekeep 💜

• -s, --indent-size — indentation size. default [4]. four spaces of pure elegance ✨
• -c, --indent-char — the indentation character. default [" "]. yes, a single space. iconic.
• -t, --indent-with-tabs — indent with tabs instead. this one overrides -s and -c, so pick a side and commit 💀
• -e, --eol — the character(s) used as line terminators. default is the first newline in the file, otherwise "\n
• -n, --end-with-newline — end the output with a newline. tidy queen behavior 👑
• --indent-empty-lines — keep the indentation on empty lines. yes, even the blank ones get love.
• --templating — a list of templating languages. the options are (auto,none,angular,django,erb,handlebars,php,smarty) and the default is ["auto", auto = none in JavaScript, auto = all except angular in html (and inline javascript/css)] — so auto means none in JavaScript, and in html (plus inline javascript/css) it means everything except angular. no cap, that's literally what it says.
• --editorconfig — use EditorConfig to set up the options. let the config file do the talking 🫶
• -b, --brace-style — brace style, one of [collapse|expand|end-expand], default ["collapse"]
• -I, --indent-inner-html — indent the body and head sections. default is false.
• -H, --indent-handlebars — indent handlebars. default is false.
• -S, --indent-scripts — one of [keep|separate|normal], default ["normal"]
• -w, --wrap-line-length — wrap lines that exceed N characters. default [0], so by default she does not wrap, she lets it flow 🌊
• -A, --wrap-attributes — wrap html tag attributes onto new lines. pick from [auto|force|force-aligned|force-expand-multiline|aligned-multiple|preserve|preserve-aligned], default ["auto"]
• -M, --wrap-attributes-min-attrs — minimum number of html tag attributes needed for the force wrap attribute options. default [2]
• -i, --wrap-attributes-indent-size — indent wrapped tags to after N characters. default is [indent-level]
• -p, --preserve-newlines — preserve line-breaks. and --no-preserve-newlines disables it, so you can flip the whole thing off ✌️
• -m, --max-preserve-newlines — how many line-breaks get preserved in one chunk. default [10]
• -U, --unformatted — a list of tags that should not be reformatted (it defaults to inline). leave them alone, they're doing their best 🙈
• -T, --content_unformatted — a list of tags whose content should not be reformatted (defaults to pre). the outside gets the glow-up, the inside stays untouched 💅
• -E, --extra_liners — a list of tags that should have an extra newline (defaults to [head,body,/html]). breathing room, bestie 🌬️
• --unformatted_content_delimiter — keep text content together between this string. default [""]

⚠️ heads up: -r, --replace writes in-place over your input file, so if you're not 100% sure, maybe do a lil backup first. i'm just looking out for you 🥺

---

🌈 a lil sign-off 🌈

that's the whole page, bestie — html-beautify, version 1.15.4, dated March 2025. you ate that 💅✨ go forth and make your HTML gorgeous. periodt. 🎀🦋💖