Add documentation, scripts for releasing 0.1
[honey] / README.md
diff --git a/README.md b/README.md
new file mode 100644 (file)
index 0000000..b9116db
--- /dev/null
+++ b/README.md
@@ -0,0 +1,22 @@
+# 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.