diff --git a/README.md b/README.md
new file mode 100644
index 0000000..1044fa9
--- /dev/null
+++ b/README.md
@@ -0,0 +1,9 @@
+Confluence Markdown Macro
+========================
+
+This macro uses the PegDown library to convert from Markdown to HTML within Confluence.
+
+It can be accessed via:
+* Macro Browser
+* {markdown} tags
+* SOAP API using <ac:macro ac:name="markdown">/ac:macro>