diff --git a/README.md b/README.md
new file mode 100644
index 0000000..1cb513a
--- /dev/null
+++ b/README.md
@@ -0,0 +1,34 @@
+ding
+ ======= or #
+ 
+ Sub-heading
+ ----------- or ##
+ 
+ ### Another deeper heading
+ 
+ Paragraphs are separated
+ by a blank line.
+ 
+ Let 2 spaces at the end of a line to do a  
+ line break
+ 
+ Text attributes *italic*,
+ **bold**, `monospace`,~~monospace~~, `monospace` .
+ 
+ A [link](http://example.com).
+ <<<   No space between ] and (  >>>
+ 
+ Shopping list:
+ 
+   * apples
+   * oranges
+   * pears
+ 
+ Numbered list:
+ 
+   1. apples
+   2. oranges
+   3. pears
+ 
+ The rain---not the reign---in
+ Spain.