+
+
+Into this:
+
+
+
+
+
+
+Where:
+
+`main.less`
+
+ @import (inline) 'main.css';
+ div { background-image: url('path/to/file'); }
+
+`main.css`
+
+ @font-face { src: url('path/to/file'); }
+
+## API
+
+### inlineHtml( filename [, options] )
+
+Reads an HTML file and inlines all of the following that reference local assets:
+
+- LESS stylesheets - The LESS is compiled and the result is inlined within a `
+
+- CSS url data types - The reference path is replaced with a datauri. These can be used in linked stylesheets, style elements, and element style attributes.
+
+ url('file.ext') -> url('data:...')
+
+- Images - The source path is replaced with a datauri.
+
+ ->
+
+Returns a `Promise` that is fulfilled with an `html` string or a `results` object depending on the value of `options.verbose`.
+
+#### Arguments
+
+- `filename` - The filename of the HTML file to be inlined. Relative file paths are resolved relative to the filename directory.
+- `options`
+ - `less` - An object containing LESS options to pass to the less compiler. Defaults to `{}`.
+ - `verbose` - A boolean that determines the promises fulfillment value. Defaults to `false`.
+ - `true`: promise is resolved with an instance of `Results`
+ - `false`: promise is resolved with `html`
+
+#### Results object
+
+- `html` - The inlined html
+- `files` - An array of filenames of the inlined local assets.