diff --git a/README.md b/README.md
index 8ccf583..257dfbb 100644
--- a/README.md
+++ b/README.md
@@ -13,3 +13,13 @@ The app can also handle nested sections:
 { A | B | C | {D|E|F} }
 
 In this example, {D|E|F} has a 1 in 4 chance of being selected.
+
+#### Now includes synonym lookup using [Datamuse](https://www.datamuse.com/api/)
+
+Synonym syntax is syn(word).
+
+Examples:
+
+The syn(quick) {brown|white|orange|syn(colorful)}  fox jumps over the lazy {dog|cat}.
+
+Synonyms will be lookup for the words "quick" and "colorful" and replaced in the string prior to processing.