# gulp-format-html
[](https://www.npmjs.com/package/gulp-format-html)
[](https://www.npmjs.com/package/gulp-format-html)
## Install
```bash
$ npm install gulp-format-html --save-dev
# OR
$ yarn add gulp-format-html -D
```
## Setup
```js
const gulp = require('gulp')
const formatHTML = require('gulp-format-html')
// or
// const { formatHTML } = require(`gulp-format-html`)
function views() {
return gulp.src('views/**/*.html').pipe(formatHTML()).pipe(gulp.dest('dist'))
}
exports.dev = gulp.series(views)
```
```ts
import gulp from 'gulp'
import formatHTML from 'gulp-format-html'
// or
// import { formatHTML } from 'gulp-format-html'
function views() {
return gulp.src('views/**/*.html').pipe(formatHTML()).pipe(gulp.dest('dist'))
}
export const dev = gulp.series(views)
```
## Example
Input:
```html
gulp-format-htmlspanbstrongem
```
Output:
```html
gulp-format-html
span
b
strong
em
```
## Options
**gulp-format-html** is based on [js-beautify](https://github.com/beautify-web/js-beautify), Check it's [HTML options](https://github.com/beautify-web/js-beautify#css--html) for detail.
### verbose
- **type** `boolean`
- **default** `false`
Display name of file from stream that is being formatting
## Related
- [gulp-diffable-html](https://github.com/ntnyq/gulp-diffable-html) Zero config HTML formatter to make HTML more readable and to indent HTML tag text in a single newline.