diff --git a/README.md b/README.md
index 2c02887..ed10699 100644
--- a/README.md
+++ b/README.md
@@ -474,6 +474,14 @@ See also template [`file_xml2json`](#file_xml2json-path).
On that json you can work as you are used to with the json syntax. For seeing how the converted json looks you can use the `--log-verbose` command line flag
+## HTML Data comparison
+
+If the response format is specified as `"type": "html"`, we internally marshal that HTML into json using [github.com/PuerkitoBio/goquery](https://github.com/PuerkitoBio/goquery).
+
+This marshalling is less strict than for [XHTML](#file_xhtml2json-path). For example it will not raise errors for unclosed tags like `
` or `
`, as well as Javascript code inside the HTML code. But it is possible that unclosed tags are missing in the resulting JSON if the tokenizer can not find a matching closing tag.
+
+See also template [`file_html2json`](#file_html2json-path).
+
## XHTML Data comparison
If the response format is specified as `"type": "xhtml"`, we internally marshal that XHTML into json using [github.com/clbanning/mxj](https://github.com/clbanning/mxj).
@@ -1855,6 +1863,102 @@ would result in
}
```
+## `file_html2json [path]`
+
+Helper function to parse an HTML file and convert it into json
+- `@path`: string; a path to the HTML file that should be loaded. The path is either relative to the manifest or a weburl
+
+This marshalling is less strict than for [XHTML](#file_xhtml2json-path). For example it will not raise errors for unclosed tags like `
` or `
`, as well as Javascript code inside the HTML code. But it is possible that unclosed tags are missing in the resulting JSON if the [goquery](https://github.com/PuerkitoBio/goquery) tokenizer can not find a matching closing tag.
+
+### Example
+
+Content of HTML file `some/path/example.html`:
+
+```html
+
+
+
+
+
+ fylr
+
+
+
+
+
+