+# Honey - a simple markdown processor
+
+While it aims to target everything listed in the
+[Github Flavored Markdown Spec](https://github.github.com/gfm/), it currently
+does just a little bit of markdown that is actively used for consxy projects.
+
+It parser markdown into weave-html style objects which can then be turned into
+strings using the weave library.
+
+Right now it supports a basic version of:
+
+* lists of one indentation
+* headings of either ATX or underline style
+* links
+* codefences
+* emphasis and strength
+
+## Usage
+
+See [the reference page](https://consxy.com/honey/reference.html) for more information,
+but in general there is a ```honey:parse``` method that takes a string representing
+the markdown.