diff --git a/README.md b/README.md
index 791a2e0..2f50ecd 100644
--- a/README.md
+++ b/README.md
@@ -4,6 +4,9 @@ A Clojure library designed to convert
 ([Enlive](https://github.com/cgrand/enlive)ned) HTML to markdown; but, more
 generally, a framework for [HT|SG|X]ML transformation.
 
-[Documentation is here](https://simon-brooke.github.io/html-to-md/)
+[Documentation is here](https://simon-brooke.github.io/html-to-md/). In
+particular, please read the
+[introduction](https://simon-brooke.github.io/html-to-md/intro.html), which
+contains everything you want to know.