diff --git a/vlib/net/html/README.md b/vlib/net/html/README.md
new file mode 100644
index 0000000000..dcdef90f79
--- /dev/null
+++ b/vlib/net/html/README.md
@@ -0,0 +1,109 @@
+# V HTML
+
+A HTML parser made in V
+
+## Usage
+
+If description below isn't enought, see test files
+
+### Parser
+
+Responsible for read HTML in full strings or splited string and returns all Tag objets of it HTML or return a DocumentObjectModel, that will try to find how the HTML Tree is.
+
+#### split_parse(data string)
+This functions is the main function called by parse method to fragment parse your HTML
+
+#### parse_html(data string, is_file bool)
+This function is called passing a filename or a complete html data string to it
+
+#### add_code_tag(name string)
+This function is used to add a tag for the parser ignore it's content. For example, if you have an html or XML with a custom tag, like `