diff --git a/README.md b/README.md
index bb14ea8..5d6c0f2 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,18 @@
 # onthisday
 
 Show a list of the REAL events on a given date.
+
+Requires https://github.com/jsvine/markovify
+
+
+## example
+
+```
+./onthisday.py --how-many 3 --date 07/18
+
+1994 - Nadia Comăneci becomes the first ever photo posted to the metropolis of Aquileia and eventually destroys it.
+
+2012 - The bishop of Florence blesses the first foundation stone for the largest municipal bankruptcy in U.S. history.
+
+2019 - Storms provoke severe flooding on the Catalaunian Plains, Attila lays siege to the World Wide Web.
+```