diff --git a/.editorconfig b/.editorconfig
new file mode 100644
index 0000000..9142239
--- /dev/null
+++ b/.editorconfig
@@ -0,0 +1,13 @@
+# editorconfig.org
+root = true
+
+[*]
+indent_size = 2
+indent_style = space
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.md]
+trim_trailing_whitespace = false
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..3adea5b
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,54 @@
+###Node###
+
+# Logs
+logs
+*.log
+
+# Runtime data
+pids
+*.pid
+*.seed
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+
+# Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Compiled binary addons (http://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directory
+# Commenting this out is preferred by some people, see
+# https://www.npmjs.org/doc/misc/npm-faq.html#should-i-check-my-node_modules-folder-into-git-
+node_modules
+
+# Users Environment Variables
+.lock-wscript
+
+
+###OSX###
+
+.DS_Store
+.AppleDouble
+.LSOverride
+
+# Icon must end with two \r
+Icon

+
+# Thumbnails
+._*
+
+# Files that might appear on external disk
+.Spotlight-V100
+.Trashes
+
+# Directories potentially created on remote AFP share
+.AppleDB
+.AppleDesktop
+Network Trash Folder
+Temporary Items
+.apdisk
\ No newline at end of file
diff --git a/.npmignore b/.npmignore
new file mode 100644
index 0000000..85e7c0e
--- /dev/null
+++ b/.npmignore
@@ -0,0 +1,62 @@
+###Node###
+
+# Logs
+logs
+*.log
+
+# Runtime data
+pids
+*.pid
+*.seed
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+
+# Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Compiled binary addons (http://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directory
+# Commenting this out is preferred by some people, see
+# https://www.npmjs.org/doc/misc/npm-faq.html#should-i-check-my-node_modules-folder-into-git-
+node_modules
+
+# Users Environment Variables
+.lock-wscript
+
+
+###OSX###
+
+.DS_Store
+.AppleDouble
+.LSOverride
+
+# Icon must end with two \r
+Icon
+
+
+# Thumbnails
+._*
+
+# Files that might appear on external disk
+.Spotlight-V100
+.Trashes
+
+# Directories potentially created on remote AFP share
+.AppleDB
+.AppleDesktop
+Network Trash Folder
+Temporary Items
+.apdisk
+
+# npm specific
+
+test
+.cz.json
+.travis.yml
+.editorconfig
diff --git a/examples/index.js b/examples/index.js
new file mode 100644
index 0000000..fde44b5
--- /dev/null
+++ b/examples/index.js
@@ -0,0 +1,36 @@
+'use strict';
+
+/**
+ * html-to-markdown
+ * Copyright(c) 2015-2015 Harminder Virk
+ * MIT Licensed
+*/
+
+var converter = require('../index');
+
+var html = `<div>
+  <h2> This is a dummy heading for Lorem guy </h2>
+  <h3> I am sub heading buddy </h3>
+  <p> This is a paragrap buddy </p>
+  <ul>
+    <li> This is ul 1 </li>
+  </ul>
+  <ol>
+    <li> This is ol 1 </li>
+  </ol>
+  <ul>
+    <li> This is ul 2 </li>
+  </ul>
+  <section> This is a section </section>
+  <pre>
+    var name = "foo";
+  </pre>
+  <blockquote>
+    This is super quote
+    In multiple lines
+  </blockquote>
+  <b> This is bold tag </b>
+  <i> Some italic </i>
+</div>
+`
+console.log(converter.convert(html))
\ No newline at end of file
diff --git a/index.js b/index.js
new file mode 100644
index 0000000..9e79096
--- /dev/null
+++ b/index.js
@@ -0,0 +1,9 @@
+'use strict';
+
+/**
+ * html-to-markdown
+ * Copyright(c) 2015-2015 Harminder Virk
+ * MIT Licensed
+*/
+
+module.exports = require('./src/index.js');
\ No newline at end of file
diff --git a/package.json b/package.json
new file mode 100644
index 0000000..ef74e9f
--- /dev/null
+++ b/package.json
@@ -0,0 +1,26 @@
+{
+  "name": "html-to-markdown",
+  "version": "1.0.0",
+  "description": "html to markdown converter with zero dependencies",
+  "main": "index.js",
+  "directories": {
+    "example": "examples"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "html-to-markdown",
+    "markdown"
+  ],
+  "author": "amanvirk",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/thetutlage/html-to-markdown.git"
+  },
+  "bugs": {
+    "url": "https://github.com/thetutlage/html-to-markdown/issues"
+  },
+  "homepage": "https://github.com/thetutlage/html-to-markdown#readme"
+}
diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..c73dbb0
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,35 @@
+# Html to markdown converter
+
+Html to markdown converter is a dependency free converter which replaces html with a valid markdown syntax. I have just started working on it, so all tags may not be supported.
+
+## Supported Platforms
+
+1. Web browsers.
+2. NodeJs
+
+## Tags Supported
+
+1. h1,h2,h3,h4,h5,h6
+2. p
+3. ul,ol
+4. blockquote,
+5. pre
+6. bold,strong
+7. italic,em
+
+## Converting Html Documents
+
+```javascript
+var converter = require('html-to-markdown');
+var markdown = converter.convert('<h2> Happy Journey </h2>');
+```
+
+## Extending to add your own formatters.
+
+```javascript
+var converter = require('html-to-markdown');
+converter.use(function (html) {
+  // making required changes
+  // and return new html
+})
+```
diff --git a/src/formatters.js b/src/formatters.js
new file mode 100644
index 0000000..4bb055d
--- /dev/null
+++ b/src/formatters.js
@@ -0,0 +1,184 @@
+'use strict';
+
+/**
+ * html-to-markdown
+ * Copyright(c) 2015-2015 Harminder Virk
+ * MIT Licensed
+*/
+
+var headingRegex = /<h(\d*)>([\s\S]*?)<\/h\d*>/gim
+var pRegex = /<p>([\s\S]*?)<\/p>/gim
+var ulRegex = /<ul>([\s\S]*?)<\/ul>/gim
+var olRegex = /<ol>([\s\S]*?)<\/ol>/gim
+var liRegex = /<li>([\s\S]*?)<\/li>/gim
+var preRegex = /<pre>([\s\S]*?)<\/pre>/gim
+var blockQuoteRegex = /<blockquote>([\s\S]*?)<\/blockquote>/gim
+var boldRegex = /<(?:b|strong)>([\s\S]*?)<\/\w*>/gim
+var italicRegex = /<(?:i|em)>([\s\S]*?)<\/\w*>/gim
+
+/**
+ * @description executes a regex to replace matched text with 
+ * selected group with optional pre and postfix
+ * @method makeRegex
+ * @param  {String}  regex  [description]
+ * @param  {String}  doc    [description]
+ * @param  {String}  before [description]
+ * @param  {String}  after  [description]
+ * @return {String}         [description]
+ */
+function makeRegex (regex, doc, before, after, replaceFn) {
+  var matches = [];
+  var newDoc = doc;
+  var replaceString;
+  while(matches = regex.exec(doc)){
+    if(matches && matches[1]){
+      replaceString = before || '';
+      var replaceText = matches[1].trim()
+      if(replaceFn && typeof(replaceFn) === 'function'){
+        replaceText = replaceFn(matches)
+      }
+      replaceString += replaceText;
+      replaceString += after || '';
+      newDoc = newDoc.replace(matches[0],replaceString);
+    }
+  }
+  return newDoc
+}
+
+/**
+ * @description replaces html headings with equalent markdown
+ * syntax
+ * @method replaceHeading
+ * @param  {String}       doc [description]
+ * @return {String}           [description]
+ */
+function replaceHeading (doc) {
+  return makeRegex(headingRegex, doc, null, null, function (match) {
+    return addHashes(match[1]) + match[2]
+  });
+}
+
+/**
+ * @description replaces ul section with equalent markdown
+ * syntax
+ * @method replaceUl
+ * @param  {String}       doc [description]
+ * @return {String}           [description]
+ */
+function replaceUl (doc) {
+  return makeRegex(ulRegex, doc, null, null, function (match) {
+    return replaceLi(match[1],'ul')
+  });
+}
+
+/**
+ * @description replaces ol section with equalent markdown
+ * syntax
+ * @method replaceOl
+ * @param  {String}       doc [description]
+ * @return {String}           [description]
+ */
+function replaceOl (doc) {
+  return makeRegex(olRegex, doc, null, null, function (match) {
+    return replaceLi(match[1],'ol')
+  });
+}
+
+/**
+ * @description replaces paragraph section with equalent markdown
+ * syntax
+ * @method replaceParagraph
+ * @param  {String}       doc [description]
+ * @return {String}           [description]
+ */
+function replaceParagraph (doc) {
+  return makeRegex(pRegex, doc);
+}
+
+/**
+ * @description replaces pre section with equalent markdown
+ * syntax
+ * @method replacePre
+ * @param  {String}       doc [description]
+ * @return {String}           [description]
+ */
+function replacePre (doc) {
+  return makeRegex(preRegex, doc, '`', '`');
+}
+
+/**
+ * @description replaces blockquote section with equalent markdown
+ * syntax
+ * @method replaceBlockQuote
+ * @param  {String}       doc [description]
+ * @return {String}           [description]
+ */
+function replaceBlockQuote (doc) {
+  return makeRegex(blockQuoteRegex, doc, '> ');
+}
+
+/**
+ * @description replaces bold|strong section with equalent markdown
+ * syntax
+ * @method replaceBold
+ * @param  {String}       doc [description]
+ * @return {String}           [description]
+ */
+function replaceBold (doc) {
+  return makeRegex(boldRegex, doc, '** ', ' **');
+}
+
+/**
+ * @description replaces i|em section with equalent markdown
+ * syntax
+ * @method replaceItalic
+ * @param  {String}       doc [description]
+ * @return {String}           [description]
+ */
+function replaceItalic (doc) {
+  return makeRegex(italicRegex, doc, '* ', ' *');
+}
+
+/**
+ * @description replaces li tags with equalent markup based
+ * upon their parent tag
+ * @method replaceLi
+ * @param  {String}  doc [description]
+ * @param  {String}  tag [description]
+ * @return {String}      [description]
+ */
+function replaceLi (doc, tag) {
+  var matches = [];
+  var newDoc = doc;
+  var replaceIndex = 0;
+  var replaceTag = '';
+  while(matches = liRegex.exec(doc)) {
+    if (matches && matches[1]) {
+      if (tag !== 'ul') {
+        replaceIndex++;
+        replaceTag = replaceIndex + '. ';
+      }else{
+        replaceTag = '* ';
+      }
+      newDoc = newDoc.replace(matches[0],replaceTag+matches[1].trim());
+    }
+  }
+  return newDoc
+}
+
+/**
+ * @descriptions adds number of hashes to headings
+ * based upon heading weight
+ * @method addHashes
+ * @param  {Number}  count [description]
+ */
+function addHashes (count) {
+  count = Number(count);
+  var string = '';
+  for(var x=0;x<count;x++){
+    string += '#'
+  }
+  return string;
+}
+
+module.exports = [replaceHeading,replaceParagraph,replacePre,replaceUl,replaceOl,replaceBold,replaceItalic,replaceBlockQuote]
diff --git a/src/index.js b/src/index.js
new file mode 100644
index 0000000..10cc488
--- /dev/null
+++ b/src/index.js
@@ -0,0 +1,63 @@
+'use strict';
+
+/**
+ * html-to-markdown
+ * Copyright(c) 2015-2015 Harminder Virk
+ * MIT Licensed
+*/
+
+var formatters = require('./formatters');
+var extrasRegex = /<\/?(?:div|address|section|article|span)>/gim
+
+/**
+ * @description replacing unncessary html tags
+ * @method replaceExtras
+ * @param  {String}      doc
+ * @return {String}
+ */
+function replaceExtras(doc) {
+  var matches = [];
+  var newDoc = doc;
+  newDoc = newDoc.replace(extrasRegex,'');
+  return newDoc
+}
+
+module.exports = {
+
+  /**
+   * @description converts given html to a markdown
+   * document
+   * @method convert
+   * @param  {String} html
+   * @return {String}
+   */
+  convert: function (html) {
+
+    /**
+     * replacing unncessary html tags
+     * @type {String}
+     */
+    html = replaceExtras(html);    
+
+    /**
+     * looping through registered formatters
+     */
+    for(var x=0;x<formatters.length; x++){
+      var formatter = formatters[x];
+      if(typeof(formatter) === 'function'){
+        html = formatter(html)
+      }
+    }
+    return html;
+  },
+
+  /**
+   * adding a new formatter to the list of formatters
+   * @method use
+   * @param  {Function} formatter
+   * @return {void}
+   */
+  use: function (formatter) {
+    formatters.push(formatter)
+  }
+}
\ No newline at end of file